Sun Microsystems 5800 manual Hcqrsnextez

Synchronous C API Functions

Return Codes

HCERR_OK

HCERR_OOM

HCERR_BAD_REQUEST

HCERR_NULL_SESSION

HCERR_INVALID_SESSION

HCERR_ILLEGAL_ARGUMENT

See Also

“hc_qrs_free” on page 99

hc_qrs_next_ez

Fetches the 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

This function fetches an OID and optionally name-value record from the query result set. Once the last 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 finishedp is 0.

nvrp

OUT: Updated to point to a name-value record with the metadata from the OID matching the query, assuming the query specified selects and assuming finishedp is 0. Note that you must free the name-value record using “hc_nvr_free” on page 66.

96 Sun StorageTek 5800 System Client API Reference Manual • June 2008