DeleteAce
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