Creatingand Freeing Name-Value Records
Thefollowing functions are dened to create and free name-value records:
■“hc_nvr_create”on page 65
■“hc_nvr_free”on page 66
hc_nvr_create
Createsa name-value record.
Synopsis
hcerr_t hc_nvr_create(hc_session_t *session,
hc_long_t nslots,
hc_nvr_t **nvrp);
Description
Thisfunction creates a name-value record with a designated initial size that is associated with a
particularsession. Metadata that is added to this name-value record must match the schema
associatedwith 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.
ReturnCodes
HCERR_OK
HCERR_ILLEGAL_ARGUMENT
HCERR_OOM
SynchronousCAPI Functions
Chapter3 • Sun StorageTek 5800 System C Client API 65