Sun Microsystems 5800 manual Hcnvrgetvalueatindex

Synchronous C API Functions

hc_nvr_get_value_at_index

Iterates through the names and values in a name-value record.

Synopsis

hc_nvr_get_value_at_index(hc_nvr_t *nvr,

hc_long_t index,

char **namep,

hc_value_t *valuep);

Description

This function iterates through the names and values in a name-value record. The returned names are read-only. Unpredictable results will occur if either the name or the value is referenced after either “hc_nvr_free” on page 66 or “hc_nvr_create_from_string_arrays” on page 84 is called on this name-value record.

Parameters

nvr

Points to a name-value-record.

index

IN: The index to examine.

namep

OUT: Updated to point to the attribute name at the specified index.

valuep

OUT: Updated with the “hc_value_t” on page 47 type-tagged value at the specified index.

Return Codes

HCERR_OK

HCERR_INVALID_NVR

HCERR_ILLEGAL_ARGUMENT

HCERR_NO_MORE_ARGUMENTS

HCERR_OOM

Chapter 3 • Sun StorageTek 5800 System C Client API 77