Sun Microsystems Sun StorageTek 5800 - Manual (Page 77)

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
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API 77