hc_nvr_get_value_at_index
Iteratesthrough 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
Thisfunction iterates through the names and values in a name-value record. The returned
namesare read-only. Unpredictable results will occur if either the name or the value is
referencedafter either “hc_nvr_free” on page 66 or “hc_nvr_create_from_string_arrays”
onpage 84 is called on this name-value record.
Parameters
nvr
Pointsto a name-value-record.
index
IN:The index to examine.
namep
OUT:Updated to point to the attribute name at the specied index.
valuep
OUT:Updated with the “hc_value_t” on page 47 type-tagged value at the specied index.
ReturnCodes
HCERR_OK
HCERR_INVALID_NVR
HCERR_ILLEGAL_ARGUMENT
HCERR_NO_MORE_ARGUMENTS
HCERR_OOM
SynchronousCAPI Functions
Chapter3 • Sun StorageTek 5800 System C Client API 77