NAME

SYNOPSIS

#include <dce/dce.h>
#include <dce/dbif.h>

void dce_db_std_header_init(
    dce_db_handle_t handle,
    dce_db_header_t *hdr,
    uuid_t *uuid,
    uuid_t *acl_uuid,
    uuid_t *def_object_acl,
    uuid_t *def_container_acl,
    unsigned32 ref_count,
    error_status_t *status);

PARAMETERS

Input

handle

A handle, returned from dce_db_open(), that identifies the backing store being used.

hdr

Pointer to the object header part of the users' structure.

uuid

The UUID to be placed into the header. Can be NULL.

acl_uuid

The UUID of the ACL protecting this object, to be placed into the header. Can be NULL.

def_object_acl

The UUID of the default object ACL, to be placed into the header. Can be NULL.

def_container_acl

The UUID of the default container ACL, to be placed into the header. Can be NULL.

ref_count

The reference count to be placed into the header.

Output

status

A pointer to the completion status. On successful completion, the routine returns error_status_ok. Otherwise, it returns an error.

DESCRIPTION

The dce_db_std_header_init() routine initializes the fields of the standard header for a data object whose backing store is identified by the handle parameter. The fields are only set in memory and should be stored to the backing store by one of the store routines. The handle was obtained from dce_db_open(), which must have been called with the db_c_std_header flag.

ERRORS

db_s_bad_header_type

The header type is not dce_db_header_std.

error_status_ok

The call was successful.

RELATED INFORMATION

Functions: dce_db_header_fetch(3dce).