Sun Microsystems Sun StorageTek 5800 - Manual (Page 98)

Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_RESULT_SET
hc_qrs_get_query_integrity_time
Returns a time that helps get more detail on which store index exceptions might still be
unresolved.
Synopsis
hcerr_t hc_qrs_get_query_integrity_time(hc_query_result_set_t *rset,
hc_long_t *query_timep);
Description
If the query integrity time is non-zero, then all store index exceptions whose object creation
time falls before the query integrity time have been resolved. Stored objects from before that
time should show up in all matching query result sets. Store index exceptions that occurred
after that time may not yet have been resolved, and hence might still be missing from a
matching query result set. If the Query Integrity Time is zero, then the set of results in this
ResultSet
is not known to be complete. Note that hc_is_query_complete will return a
non-zero completep value if and only if hc_get_query_integrity_time would set
query_timep
to non-zero query integrity time.
Time values from getQueryIntegrityTime can be compared to object creation time values
returned in the creation_time field of the hc_system_record_t structure to determine if a
particular store operation has been resolved. Note: the query integrity time as reported may well
be earlier than the actual oldest time of a still-unresolved store index exception. The query
integrity time can even go backwards, in other words, a later query can report an earlier query
integrity time.
Parameter
rset
Updated to point to the new query result set. See “hc_query_result_set_t” on page 49 .
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
Synchronous C API Functions
Sun StorageTek 5800 System Client API Reference Manual • June 2008 98