Retrieving Name-Value Records

Synchronous C API Functions

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);

This function retrieves the number of metadata name and value tuples in the specified name-value record.

nvr

IN: Points to a name-value-record.

retcount

OUT: Updated to contain the count of name-value pairs.

HCERR_OK

HCERR_BAD_REQUEST

HCERR_OOM

HCERR_INVALID_NVR

76	Sun StorageTek 5800 System Client API Reference Manual • June 2008