Sun Microsystems Sun StorageTek 5800 - Manual (Page 91)

Retrieving Data and Metadata
The following functions are defined 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
Retrieves data for the specified OID.
Synopsis
hcerr_t hc_retrieve_ez(hc_session_t *session,
*data_writer,
void *cookie,
hc_oid *oid);
Description
This function retrieves data for the specified 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”
on page 50 .
cookie
IN: The opaque data delivered to the data_writer callback to identify this data stream.
oid
IN: Identifier for the metadata record to retrieve.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API 91