Sun Microsystems Sun StorageTek 5800 - Manual (Page 71)

hc_nvr_add_binary
Adds new metadata value of type binary.
Synopsis
hcerr_t hc_nvr_add_binary(hc_nvr_t *nvr,
hc_string_t name,
int size,
unsigned char *bytes);
Description
This function adds a new metadata name-value-type tuple to a designated name-value record,
where type is binary data. The name-value record automatically expands as needed. The name
and data are copied into the structure.
Parameters
nvr
Points to a name-value-record.
name
IN: Name for the tuple.
size
IN: The size of the data.
bytes
IN: The binary data.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_NVR
HCERR_ILLEGAL_ARGUMENT
HCERR_ILLEGAL_VALUE_FOR_METADATA
HCERR_NO_SUCH_ATTRIBUTE
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API 71