hc_store_both_ez

Stores a metadata record and associated data.

Synopsis

     hcerr_t hc_store_both_ez (hc_session_t *session,
          *data_source_reader, 
          void *cookie,
          hc_nvr_t *nvr,
          hc_system_record_t *system_record);

Description

This function stores both object data and metadata and returns a system_record descriptor. The status from this operation can be reclaimed using hc_session_get_status.

Parameters

session

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

data_source_reader

IN: The source of data to be stored. See read_from_data_source.

cookie

IN: An opaque data structure (cookie) to be provided to data_source_reader. For example, this could be a file descriptor.

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_ILLEGAL_ARGUMENT
     HCERR_NO_SUCH_TYPE
     HCERR_XML_BUFFER_OVERFLOW