Sun StorageTek 5800 System Client API Reference Manual

hc_nvr_add_from_string

Adds a new metadata value where the value always starts out as a string.

Synopsis

    hcerr_t hc_nvr_add_from_string(hc_nvr_t *nvr, 
          char *name, 
          char *value);

Description

This is a convenient function for adding a new metadata name-value-type tuple to a designated name-value, where the value always starts out as a string. The correct metadata type for name must be looked up from the schema. The name-value record will automatically expand as needed. The string is copied into the structure.

Parameters

nvr

Points to a name-value-record.

name

IN: Name for the tuple.

value

IN: The string value to be added.

Return Codes

     HCERR_OK
     HCERR_BAD_REQUEST
     HCERR_OOM
     HCERR_INVALID_NVR
     HCERR_ILLEGAL_ARGUMENT