Synchronous C API Functions

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

Chapter 3 • Sun StorageTek 5800 System C Client API

93

Page 93
Image 93
Sun Microsystems 5800 manual Hcrangeretrieveez