Sun Microsystems 5800 manual Hcnvraddbinary

Synchronous C API Functions

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

Chapter 3 • Sun StorageTek 5800 System C Client API 71