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 or hc_nvr_create_from_string_arrays 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 type-tagged value at the specified index.

Return Codes

     HCERR_OK
     HCERR_INVALID_NVR
     HCERR_ILLEGAL_ARGUMENT
     HCERR_NO_MORE_ARGUMENTS
     HCERR_OOM