dce_db_std_header_init(3dce)

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

The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages.

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)