NAME

dce_acl_copy_acl — Copies an ACL

Synopsis

void dce_acl_copy_acl(
sec_acl_t ∗source,
sec_acl_t ∗target,
error_status_t ∗status);

Parameters

Input

sourceA pointer to the ACL to be copied. 

targetA pointer to the new ACL that is to receive the copy. 

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_copy_acl() routine makes a copy of a specified ACL.  The caller passes the space for the target ACL, but the space for the sec_acl_entries array is allocated.  To free the allocated space, call dce_acl_obj_free_entries(), which frees the entries, but not the ACL itself. 

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. 

rpc_s_no_memory
The rpc_sm_allocate() routine could not obtain memory. 

error_status_ok
The call was successful.

Related Information

Functions: dce_acl_obj_free_entries(3sec).