Sun StorageTek 5800 System Client API Reference Guide

hc_nvr_create_from_string_arrays

Creates name-value-record from string names and string values.

Synopsis

     hcerr_t hc_nvr_create_from_string_arrays(hc_session_t *session,
          hc_nvr_t **nvrp, 
          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 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