Sun Microsystems Sun StorageTek 5800 - Manual (Page 76)

Retrieving Name-Value Records
The following functions are defined to retrieve name-value records:
■ “hc_nvr_get_count” on page 76
■ “hc_nvr_get_value_at_index” on page 77
■ “hc_nvr_get_long” on page 78
■ “hc_nvr_get_double” on page 79
■ “hc_nvr_get_string” on page 80
■ “hc_nvr_get_binary” on page 81
■ “hc_nvr_get_date” on page 82
■ “hc_nvr_get_time” on page 82
■ “hc_nvr_get_timestamp” on page 83
hc_nvr_get_count
Retrieves the number of metadata name and value tuples in this name-value record.
Synopsis
hcerr_t hc_nvr_get_count(hc_nvr_t *nvr,
hc_long_t *retcount);
Description
This function retrieves the number of metadata name and value tuples in the specified
name-value record.
Parameters
nvr
IN: Points to a name-value-record.
retcount
OUT: Updated to contain the count of name-value pairs.
Return Codes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_NVR
Synchronous C API Functions
Sun StorageTek 5800 System Client API Reference Manual • June 2008 76