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.

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