beautypg.com

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

background image

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