hc_nvr_convert_to_string_arrays
Convertsname-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
Thisfunction converts a name-value-record into parallel tables of string names and string
values.This destructively modies the name-value record and frees it, so do not call
“hc_nvr_free”on page 66 after calling this function.
Whenthe conversion is nished, each string in the names and values tables should be freed with
thedesignated deallocator (for example, free), as well as the names and values tables
themselves.
Note– Any time there is a conversion from a double typeto or from a string type,there might
bea 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.
ReturnCodes
HCERR_OK
HCERR_BAD_REQUEST
SynchronousCAPI Functions
SunStorageTek5800 System Client API Reference Manual • June 200886