VMS Help DCE, dce_intro, dce_db_intro, dce_db_std_header_init  *Conan The Librarian (sorry for the slow response - running on an old VAX)

 NAME
   dce_db_std_header_init - Initializes a standard backing store header

 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