Sun Microsystems 5800 manual Hcnvraddvalue

Synchronous C API Functions

■“hc_nvr_add_timestamp” on page 74

■“hc_nvr_add_from_string” on page 75

hc_nvr_add_value

Adds a new metadata value.

Synopsis

hcerr_t hc_nvr_add_value(hc_nvr_t *nvr,

char *name, hc_value_t value);

Description

This function adds a new metadata name-value-type tuple to a designated name-value record. The name-value record will automatically expand as needed.

Parameters

nvr

Points to a name-value-record.

name

IN: Name for the tuple.

value

IN: Value for the tuple, in the type-tagged “hc_value_t” on page 47 format.

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 67