Sun Microsystems 5800 manual Hcnvraddstring

Synchronous C API Functions

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

70 Sun StorageTek 5800 System Client API Reference Manual • June 2008