Sun Microsystems 5800 manual Hcnvrgetstring

Synchronous C API Functions

hc_nvr_get_string

Retrieves a value of a Unicode UTF-8 string.

Synopsis

hcerr_t hc_nvr_get_string(hc_nvr_t *nvr,

char *name,

hc_string_t *retstring);

Description

This function retrieves the value of a Unicode UTF-8 string associated with an indicated attribute name in a name-value record. Note that the memory pointed to will be freed when the record is freed.

Parameters

nvr

Points to a name-value-record.

name

IN: Attribute name to look for.

retstring

OUT: Updated to contain the hc_string_t value.

Return Codes

HCERR_OK

HCERR_BAD_REQUEST

HCERR_OOM

HCERR_INVALID_NVR

HCERR_ILLEGAL_VALUE_FOR_METADATA

HCERR_ILLEGAL_ARGUMENT

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