Sun Microsystems Sun StorageTek 5800 - Manual (Page 92)

HCERR_OOM
HCERR_NULL_SESSION
HCERR_INVALID_SESSION
HCERR_INVALID_OID
hc_retrieve_metadata_ez
Retrieves a metadata record for the specified OID.
Synopsis
hcerr_t hc_retrieve_metadata_ez (hc_session_t *session,
hc_oid *oid,
hv_nvr_t **nvrp);
Description
This function retrieves a metadata record for the specified OID. When it has finished, you
should call
“hc_nvr_free” on page 66 to free the name-value-record.
Parameters
session
IN: The session for the host and port to talk to.
oid
IN: An identifier of the metadata record to retrieve.
nvrp
OUT: Updated with a pointer to a dynamically allocated name-value record with the metadata.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_NULL_SESSION
HCERR_INVALID_SESSION
HCERR_INVALID_OID
Synchronous C API Functions
Sun StorageTek 5800 System Client API Reference Manual • June 2008 92