Sun Microsystems 5800 manual Char **names Char **values Hclongt nitems

Synchronous C API Functions

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 “hc_nvr_t” on page 48 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

Chapter 3 • Sun StorageTek 5800 System C Client API 85