Sun Microsystems 5800 manual Hcnvraddtime

Synchronous C API Functions

hc_nvr_add_time

Adds new metadata value of type time.

Synopsis

#include <time.h>

hcerr_t hc_nvr_add_time(hc_nvr_t *nvr,

hc_string_t name,

time_t *value);

Description

This function adds a new metadata name-value-type tuple to a designated name-value record. The value represents seconds since midnight.

The name-value record automatically expands as needed. The name and value are copied into the structure.

Parameters

nvr

Points to a name-value-record.

name

IN: Name for the tuple.

value

IN: The time_t (time.h) value.

Return Codes

HCERR_OK

HCERR_BAD_REQUEST

HCERR_OOM

HCERR_INVALID_NVR

HCERR_ILLEGAL_ARGUMENT

HCERR_ILLEGAL_VALUE_FOR_METADATA

HCERR_NO_SUCH_ATTRIBUTE

Chapter 3 • Sun StorageTek 5800 System C Client API 73