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
     HCERR_NULL_SESSION
     HCERR_INVALID_SESSION
     HCERR_INVALID_OID
     HCERR_ILLEGAL_ARGUMENT