Sun Microsystems 5800 - page 95

int results_per_fetch,
hc_query_result_set_t **rsetp);
Description
Thisfunction retrieves OIDs and optionally name-value records matching a query. If the
selectslist is NULL, only OIDs are retrieved. If selects isnot NULL, name-value records are
alsoretrieved and should each be freed using “hc_nvr_free” on page 66. In both cases the result
setshould be freed using “hc_qrs_free” on page 99.
Note– When a query is incorrect and elicits an error from the server, the error is often reported
after“hc_qrs_free” on page 99and not from hc_query_ez. Your application should be
preparedto receive and report an error from either place.
Parameters
session
IN:The session for the host and port to talk to.
query
IN:Query (where clausewith names in single quotes).
selects
IN:Points to an array of “hc_string_t” on page 46, each member of which is the name of a eld
toretrieve from the metadata (select clause).Set to NULL toonly retrieve OIDs matching the
query.
n_selects
IN:The number of items in the select clause.
results_per_fetch
IN:The number of results to return on each fetch from the server. results_per_fetch mustbe
greaterthan 0.
rsetp
OUT:Updated to point to the new result set. See “hc_query_result_set_t” on page 49.
SynchronousCAPI Functions
Chapter3 • Sun StorageTek5800 System C Client API 95