Sun Microsystems 5800 User Manual

Page of 136
hc_nvr_add_string
Adds a new metadata value of type Unicode UTF-8 string.
Synopsis
hcerr_t hc_nvr_add_string(hc_nvr_t *nvr,
char *name,
hc_string_t value);
Description
This function adds a new metadata name-value-type tuple to a designated name-value record,
where type is a Unicode UTF-8 string. The name-value record automatically expands as
needed. The string is copied into the structure.
Parameters
nvr
Points to a name-value-record.
name
IN: Name for the tuple.
value
IN: The hc_string_t value.
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
Sun StorageTek 5800 System Client API Reference Manual • June 2008
70