IN:Should range from 0up 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
referencesa type that the client library does not support, then the type is returned as
HC_UNKNOWN_TYPE.
ReturnCodes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_SCHEMA
HCERR_ILLEGAL_ARGUMENT
SeeAlso
“hc_schema_get_count”on page 61
ManipulatingName -ValueRecords
5800system synchronous C API functions are dened to perform the following name-value
recordmanipulation tasks:
■“Usingthe API for Storing Name-Value Records” on page 63
■“UsingReturned Name-Value Records” on page 64
■“Creatingand Freeing Name-Value Records” on page 65
■“BuildingName-Value Records” on page 66
■“RetrievingName-Value Records” on page 76
■“Creatingand Converting Name-Value Records From and To String Arrays” on page 84
Usingthe API for Storing Name -ValueRecords
Acommon way of storing metadata in the synchronous C API for the 5800 system is to use the
name-valuerecord API.
SynchronousCAPI Functions
Chapter3 • Sun StorageTek 5800 System C Client API 63