hc_nvr_get_binary
Retrievesa metadata value of type binary.
Synopsis
hcerr_t hc_nvr_get_binary(hc_nvr_t *nvr,
hc_string_t name,
int *size,
unsigned char **bytes);
Thisfunction retrieves the value of type binary associatedwith an indicated attribute name in a
name-valuerecord. The binary data is not copied and is freed when the name-value record is
freed.
Parameters
nvr
Pointsto a name-value-record.
name
IN:Name for the tuple.
size
OUT:Updated with the size of the data.
bytes
OUT:Updated to point to the binary data.
ReturnCodes
HCERR_OK
HCERR_BAD_REQUEST
HCERR_OOM
HCERR_INVALID_NVR
HCERR_ILLEGAL_ARGUMENT
HCERR_ILLEGAL_VALUE_FOR_METADATA
HCERR_NO_SUCH_ATTRIBUTE
SynchronousCAPI Functions
Chapter3 • SunStorageTek 5800 System C Client API 81