hc_nvr_convert_to_string_arrays
Converts name-value-record to string names and string values.
Synopsis
hcerr_t hc_nvr_convert_to_string_arrays(hc_nvr_t *nvr,
char ***namesp,
char ***valuesp,
int *nitemsp);
Description
This function converts a name-value-record into parallel tables of string names and string
values. This destructively modies the name-value record and frees it, so do not call
“hc_nvr_free” on page 66 after calling this function.
When the conversion is nished, each string in the names and values tables should be freed with
the designated deallocator (for example, free), as well as the names and values tables
themselves.
Note – Any time there is a conversion from a double type to or from a string type, there might
be a loss of precision.
Parameters
nvr
IN: The name-value-record.
namesp
OUT: Updated to point to an array of string names.
valuesp
OUT: Updated to point to an array of string values.
nitemsp
OUT: Updated to the number of active elements in the paired arrays.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
SynchronousCAPI Functions
SunStorageTek 5800SystemClientAPIReferenceManual • June 200886