Sun StorageTek 5800 System Client API Reference Guide

hc_nvr_add_binary

Adds new metadata value of type binary.

Synopsis

     hcerr_t hc_nvr_add_binary(hc_nvr_t *nvr, 
          hc_string_t name, 
          int size, 
          unsigned char *bytes);

Description

This function adds a new metadata name-value-type tuple to a designated name-value record, where type is binary data. The name-value record automatically expands as needed. The name and data are copied into the structure.

Parameters

nvr

Points to a name-value-record.

name

IN: Name for the tuple.

size

IN: The size of the data.

bytes

IN: 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