The DeleteAce function deletes an ACE from an ACL.
An ACE is an access-control entry. An ACL is an access-control list.
BOOL DeleteAce(
| PACL pAcl, | // pointer to access-control list |
| DWORD dwAceIndex | // index of ACE position in ACL |
| ); |
Parameters
pAcl
Points to an ACL structure. The ACE specified by the dwAceIndex parameter is removed from this ACL.
dwAceIndex
Specifies the ACE to delete. A value of 0 corresponds to the first ACE in the ACL, 1 to the second ACE, and so on.
Return Values
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.
Remarks
An application can use the ACL_SIZE_INFORMATION structure retrieved by the GetAclInformation function to discover the size of the ACL and the number of ACEs it contains. The GetAce function retrieves information about an individual ACE.
See Also
ACL, ACL_SIZE_INFORMATION, AddAccessAllowedAce, AddAccessDeniedAce, AddAce, AddAuditAccessAce, GetAce, GetAclInformation