Sun StorageTek 5800 System Client API Reference Guide

hc_qrs_is_query_complete

Indicates whether results of this query are complete in the sense that all objects that match the query, aside from possible store index exceptions, are included in the result set,

Synopsis

     hcerr_t hc_qrs_is_query_complete(hc_query_result_set_t *rset,
          int *completep);

Description

Indicates whether results of this query are complete in the sense that all objects that match the query, aside from possible store index exceptions, are included in the result set. Applications that depend on completeness of query results can interrogate hc_qrs_is_query_complete after retrieving all the query results that match a particular query. When completep is set to 1, the only items that should be missing from the result set are store index exceptions that were indicated to the application by a value of 0 in the is_indexed field of the hc_system_record_t structure returned from the store.

Parameters

rset

IN: Current query result set. See hc_query_result_set_t.

completep

OUT: Points to an int that is updated to 1 if all objects that match the query (other than potential store index exceptions) should be present in the result set

Return Codes

     HCERR_OK
     HCERR_BAD_REQUEST
     HCERR_OOM
     HCERR_INVALID_RESULT_SET