Sun Microsystems Sun StorageTek 5800 - Manual (Page 97)

finishedp
OUT: Points to an int that is updated to 0 if query data has been returned and to 1 if the result
set is empty.
Return Codes
HCERR_OK
HCERR_OOM
HCERR_BAD_REQUEST
HCERR_INVALID_RESULT_SET
HCERR_ILLEGAL_ARGUMENT
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” on page 49 .
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
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API 97