Sun Microsystems 5800 User Manual

Page of 136
hc_nvr_add_date
Adds new metadata value of type date.
Synopsis
#include <time.h>
hcerr_t hc_nvr_add_date(hc_nvr_t *nvr,
hc_string_t name,struct tm *value);
Description
This function adds a new metadata name-value-type tuple to a designated name-value record.
The struct tm fields are as defined in the POSIX standard and interpreted by mktime(3C). All
fields are ignored except:
int tm_mday; /* day of the month - [1, 31] */
int tm_mon; /* months since January - [0, 11] */
int tm_year; /* years since 1900 */
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 struct tm (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
Synchronous C API Functions
Sun StorageTek 5800 System Client API Reference Manual • June 2008
72