ReturnCodes
HCERR_OK
HCERR_OOM
HCERR_BAD_REQUEST
HCERR_NULL_SESSION
HCERR_INVALID_SESSION
HCERR_ILLEGAL_ARGUMENT
SeeAlso
“hc_qrs_free”on page 99
hc_qrs_next_ez
Fetchesthe next OID and optionally name-value record from the QueryResultSet.
Synopsis
hcerr_t hc_qrs_next_ez(**rset,
hc_oid *oid,
hc_nvr_t **nvrp,
int *finishedp);
Description
Thisfunction fetches an OID and optionally name-value record from the query result set. Once
thelast result is fetched, in subsequent calls the int pointed to by finishedp is set to 1.
Parameters
rset
IN:Current query result set. See “hc_query_result_set_t” on page 49.
oid
OUT:Points to an OID that is updated to the OID of a record matching the query, assuming
finishedpis 0.
nvrp
OUT:Updated to point to a name-value record with the metadata from the OID matching the
query,assuming the query specied selects and assuming finishedp is 0. Note that you must
freethe name-value record using “hc_nvr_free” on page 66.
SynchronousCAPI Functions
SunStorageTek5800 System Client API Reference Manual • June 200896