Return codes, See also, Manipulating name-value records – Sun Microsystems Sun StorageTek 5800 User Manual
Page 63: Using the api for storing name-value records
IN: Should range from 0 up to the count-1 returned in
“hc_schema_get_count” on page 61
namep
OUT: Updated to point to a string that is an attribute name of one attribute in the schema.
typep
OUT: Updated to be the type associated with that name in the schema. If the server schema
references a type that the client library does not support, then the type is returned as
HC_UNKNOWN_TYPE
.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_SCHEMA
HCERR_ILLEGAL_ARGUMENT
See Also
“hc_schema_get_count” on page 61
Manipulating Name-Value Records
5800 system synchronous C API functions are defined to perform the following name-value
record manipulation tasks:
■
“Using the API for Storing Name-Value Records” on page 63
■
“Using Returned Name-Value Records” on page 64
■
“Creating and Freeing Name-Value Records” on page 65
■
“Building Name-Value Records” on page 66
■
“Retrieving Name-Value Records” on page 76
■
“Creating and Converting Name-Value Records From and To String Arrays” on page 84
Using the API for Storing Name-Value Records
A common way of storing metadata in the synchronous C API for the 5800 system is to use the
name-value record API.
Synchronous C API Functions
Chapter 3 • Sun StorageTek 5800 System C Client API
63