Sun Microsystems 5800 manual Creating and Freeing Name-Value Records, Hcnvrcreate

Synchronous C API Functions

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

Chapter 3 • Sun StorageTek 5800 System C Client API 65