ACLAddEntry

Function : Access Control List

ACLAddEntry - Adds an entry to an access control list.

#include <acl.h>
STATUS LNPUBLIC ACLAddEntry(

    DHANDLE  hACL,
    const char far *Name,
    WORD  AccessLevel,
    ACL_PRIVILEGES far *Privileges,
    WORD  AccessFlags);

Description :

This function adds an entry to an access control list.

Parameters : Input : hACL - Handle to an access control list.

Name - Null-terminated string pointer to user or group to be added. If you need to specify a hierarchical user name, be sure to use the fully distinguished name.

AccessLevel - Access level, ACL_LEVEL_xxx, of the entry to be added. See Symbolic Value, ACL_LEVEL.

Privileges - Pointer to privilege bit mask of the entry to be added. Use this parameter to assign roles to the entry. See Data Type, ACL_PRIVILEGES. See Data Type, ACL_PRIVILEGES.

AccessFlags - Access level modifier flags, ACL_FLAG_xxx (eg: unable to delete documents, unable to create documents), of the entry to be added.

Output : (routine) - Return status from this call - indicates either success (NOERROR), or what the error is.