RetrievingData and Metadata
Thefollowing functions are dened to retrieve data and metadata:
■“hc_retrieve_ez”on page 91
■“hc_retrieve_metadata_ez”on page 92
■“hc_range_retrieve_ez”on page 93
hc_retrieve_ez
Retrievesdata for the specied OID.
Synopsis
hcerr_t hc_retrieve_ez(hc_session_t *session,
*data_writer,
void *cookie,
hc_oid *oid);
Description
Thisfunction retrieves data for the specied OID.
Parameters
session
IN:The session for the host and port to talk to.
data_writer
IN:A function callback to store the retrieved data locally. See “write_to_data_destination”
onpage 50.
cookie
IN:The opaque data delivered to the data_writer callback to identify this data stream.
oid
IN:Identier for the metadata record to retrieve.
ReturnCodes
HCERR_OK
HCERR_BAD_REQUEST
SynchronousCAPI Functions
Chapter3 • Sun StorageTek 5800 System C Client API 91