Sun StorageTek 5800 System Client API Reference Manual

hc_store_metadata_ez

Adds a metadata record for the specified OID.

Synopsis

     hcerr_t hc_store_metadata_ez(hc_session_t *session,
          hc_oid *oid,
          hc_nvr_t *nvr,
          hc_system_record_t *system_record);

Description

This function adds a metadata record for the specified OID and returns a system_record descriptor.

Parameters

session

IN: The session for the host and port to talk to.

oid

IN: An identifier of object data to which the metadata record is attached.

nvr

IN: Pointer to a name-value record with the metadata.

system_record

OUT: Returned descriptor of a stored metadata record.

Return Codes

     HCERR_OK
     HCERR_BAD_REQUEST
     HCERR_OOM
     HCERR_NULL_SESSION
     HCERR_INVALID_SESSION
     HCERR_INVALID_NVR
     HCERR_INVALID_OID
     HCERR_ILLEGAL_ARGUMENT
     HCERR_XML_BUFFER_OVERFLOW