|
AddAccessAllowedAce The AddAccessAllowedAce function adds an access-allowed ACE to an ACL. The access is granted to a specified SID. To control whether the new ACE can be inherited by child objects, use the AddAccessAllowedAceEx function.
VB4-32,5,6
Declare Function AddAccessAllowedAce Lib "advapi32.dll" (pAcl As Byte, ByVal dwAceRevision As Long, ByVal AccessMask As Long, pSid As Byte) As Long |
|
Operating Systems Supported |
|
Requires Windows NT 3.1 or later; Win9x/ME: Not supported |
- pAcl
[in/out] Pointer to an ACL structure. This function adds an access-allowed ACE to the end of this ACL. The ACE is in the form of an ACCESS_ALLOWED_ACE structure.
- dwAceRevision
[in] Specifies the revision level of the ACL being modified.
Windows NT 4.0 and earlier: This value must be ACL_REVISION.
Windows 2000: This value can be ACL_REVISION or ACL_REVISION_DS. Use ACL_REVISION_DS if the ACL contains object-specific ACEs.
- AccessMask
[in] Specifies the mask of access rights to be granted to the specified SID.
- pSid
[in] Pointer to the SID structure representing a user, group, or logon account being granted access. |
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError. |
|