NAME

dce_acl_obj_init — Initializes an ACL

Synopsis

void dce_acl_obj_init(
uuid_t ∗mgr_type,
sec_acl_t ∗acl,
error_status_t ∗status);

Parameters

Input

mgr_typeA pointer to the UUID identifying the type of the ACL manager in question.  There may be more than one type of ACL manager protecting the object whose ACL is bound to the input handle.  Use this parameter to distinguish them. 

aclA pointer to the ACL that is to be created. 

Output

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

Description

The dce_acl_obj_init() routine initializes an ACL.  The caller passes in the pointer to the already-existing ACL structure (of type sec_acl_t), for which the caller provides the space. 

Examples

This example shows the use of dce_acl_obj_init() and the corresponding routine to free the entries, dce_acl_obj_free_entries(). 

sec_acl_t acl;
extern uuid_t my_mgr_type;
error_status_t status;
dce_acl_obj_init(&my_mgr_type, &acl, &status);
/∗ ... use the ACL ... ∗/
dce_acl_obj_free_entries(&acl, &status);

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. 

error_status_ok
The call was successful.

Related Information

Functions: dce_acl_obj_free_entries(3sec).