Sun Microsystems 5800 Computer Drive User Manual


 
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 specied index.
valuep
OUT: Updated with the
hc_value_t on page 47 type-tagged value at the specied index.
Return Codes
HCERR_OK
HCERR_INVALID_NVR
HCERR_ILLEGAL_ARGUMENT
HCERR_NO_MORE_ARGUMENTS
HCERR_OOM
SynchronousCAPI Functions
Chapter3 SunStorageTek 5800SystemCClient API 77