Sun Microsystems 5800 manual Hcnvraddfromstring

Synchronous C API Functions

hc_nvr_add_from_string

Adds a new metadata value where the value always starts out as a string.

Synopsis

hcerr_t hc_nvr_add_from_string(hc_nvr_t *nvr,

char *name,

char *value);

Description

This is a convenient function for adding a new metadata name-value-type tuple to a designated name-value, where the value always starts out as a string. The correct metadata type for name must be looked up from the schema. The name-value record will automatically expand 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 string value to be added.

Return Codes

HCERR_OK

HCERR_BAD_REQUEST

HCERR_OOM

HCERR_INVALID_NVR

HCERR_ILLEGAL_ARGUMENT

Chapter 3 • Sun StorageTek 5800 System C Client API 75