Sun Microsystems 5800 User Manual

Page of 136
char **names,
char **values,
hc_long_t nitems);
Description
This function creates a name-value-record from parallel tables of string names and string
values. The correct metadata type for each name must be looked up from the schema associated
with this session. The name-value record will automatically expand as needed. The names and
data values are copied into the
structure, so the original names table and
values table are left unchanged.
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
session
IN: The session with which this name-value record is associated.
nvrp
OUT: Updated to point to a name-value-record.
names
IN: Points to an array of string names.
values
IN: Points to an array of string values.
nitems
IN: Number of active elements in the paired arrays.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_NULL_SESSION
HCERR_INVALID_SESSION
HCERR_ILLEGAL_ARGUMENT
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API
85