Sun Microsystems 5800 Manual Do Utilizador

hc_pstmt_query_ez

Retrieves OIDs and optionally name-value records matching a prepared statement.

hcerr_t hc_pstmt_query_ez(*pstmt,hc_string_t selects[],

int n_selects,

int results_per_fetch,

hc_query_result_set_t **rsetp);

This function retrieves OIDs and optionally name-value records matching a prepared
statement.

is used to access the results in the result set. If the

selects

list is NULL, only OIDs are retrieved. If selects is not NULL, name-value records are

also retrieved and should each be freed using

. In both cases the result

set should be freed using

When a query is incorrect and elicits an error from the server, the error is often reported

after

and not from

. Your

application should be prepared to receive and report an error from either place.

pstmt

IN: Prepared statement generated by

selects

IN: Points to an array of

, each of which is the name of a field to

retrieve from the metadata (select clause). Set to NULL to only retrieve OIDs matching the
query.

n_selects

IN: The number of items in the select clause.

results_per_fetch

IN: The number of results per internal fetch.

rsetp

OUT: Updated to point to the new result set. See

Synchronous C API Functions

Chapter 3 • Sun StorageTek 5800 System C Client API

109