Hc_nvr_get_binary, Synopsis, Parameters – Sun Microsystems Sun StorageTek 5800 User Manual

Page 81: Return codes

Text mode
Original mode

hc_nvr_get_binary

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

This function retrieves the value of type binary associated with an indicated attribute name in a
name-value record. The binary data is not copied and is freed when the name-value record is
freed.

Parameters

nvr

Points to 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.

Return Codes

HCERR_OK

HCERR_BAD_REQUEST

HCERR_OOM

HCERR_INVALID_NVR

HCERR_ILLEGAL_ARGUMENT

HCERR_ILLEGAL_VALUE_FOR_METADATA

HCERR_NO_SUCH_ATTRIBUTE

Synchronous C API Functions

Chapter 3 • Sun StorageTek 5800 System C Client API