Sun Microsystems Sun StorageTek 5800 - Manual (Page 65)

Creating and Freeing Name-Value Records
The following functions are defined to create and free name-value records:
■ “hc_nvr_create” on page 65
■ “hc_nvr_free” on page 66
hc_nvr_create
Creates a name-value record.
Synopsis
hcerr_t hc_nvr_create(hc_session_t *session,
hc_long_t nslots,
hc_nvr_t **nvrp);
Description
This function creates a name-value record with a designated initial size that is associated with a
particular session. Metadata that is added to this name-value record must match the schema
associated with the session.
Parameters
session
IN: The session with which this name-value record is associated.
nslots
IN: The number of slots for name-value-type tuples.
nvrp
OUT: Updated with a pointer to a new name-value record of the designated size.
Return Codes
HCERR_OK
HCERR_ILLEGAL_ARGUMENT
HCERR_OOM
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API 65