Sun Microsystems Sun StorageTek 5800 - Manual (Page 93)

hc_range_retrieve_ez
Retrieves a specified range of data for a specified OID.
Synopsis
hc_range_retrieve_ez(hc_session_t *session,
write_to_data_destination data_writer,
void *cookie,
hc_oid *oid,
hc_long_t; firstbyte,
hc_long_t lastbyte);
Description
This function retrieves a specified range of data for a specified OID.
Parameters
session
IN: The session for the host and port to talk to.
data_writer
IN: Function callback to store the retrieved data locally.
cookie
IN: Opaque data delivered to the data_writer callback to identify this data cookie.
oid
IN: An identifier of the data record to retrieve.
firstbyte
IN: First byte of data range to retrieve.
lastbyte
IN: Last byte of data range to retrieve, or -1 for the end of the record.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API 93