RtlDeleteAce - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
#ifndef _NTRTL_H

NTSYSAPI
NTSTATUS
NTAPI
RtlDeleteAce(
    _Inout_ PACL Acl,
    _In_ ULONG AceIndex
    );

#endif

View code on GitHub
// ntifs.h

NTSYSAPI NTSTATUS RtlDeleteAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceIndex
);
View the official Windows Driver Kit DDI reference

NtDoc

This function is documented in Windows Driver Kit.

Windows Driver Kit DDI reference (nf-ntifs-rtldeleteace)

RtlDeleteAce function

Description

The RtlDeleteAce routine deletes an access control entry (ACE) from a specified access control list (ACL).

Parameters

Acl [in, out]

Pointer to the ACL to be modified. RtlDeleteAce deletes the specified ACE from this ACL.

AceIndex [in]

Specifies the ACE to delete. A value of zero corresponds to the first ACE in the ACL, 1 to the second ACE, and so on.

Return value

RtlDeleteAce returns STATUS_SUCCESS or an appropriate NTSTATUS value such as one of the following:

Return code Description
STATUS_INVALID_PARAMETER One of the parameter values was invalid.

Possible reasons for STATUS_INVALID_PARAMETER include:

Remarks

For information about calculating the size of an ACL, see the Remarks section of the reference entry for RtlCreateAcl.

To add an ACE to an ACL, use RtlAddAce.

To obtain a pointer to an ACE in an ACL, use RtlGetAce.

For more information about security and access control, see Windows security model for driver developers and the documentation on these topics in the Windows SDK.

See also

ACE

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce