RtlGetAce function (ntifs.h)

The RtlGetAce routine obtains a pointer to an access control entry (ACE) in an access control list (ACL).

Syntax

NTSYSAPI NTSTATUS RtlGetAce(
  [in]  PACL  Acl,
  [in]  ULONG AceIndex,
  [out] PVOID *Ace
);

[in] Acl

Pointer to an ACL containing the ACE to be retrieved.

[in] AceIndex

Specifies the ACE to which a pointer is retrieved. A value of zero corresponds to the first ACE in the ACL, 1 to the second ACE, and so on.

[out] Ace

Pointer to a caller-allocated variable to receive the address of the ACE within the ACL.

RtlGetAce returns STATUS_SUCCESS or an error status code such as STATUS_INVALID_PARAMETER.

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.

Requirement	Value
Minimum supported client	Windows XP
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe (kernel mode); Ntdll.dll (user mode)
IRQL	< DISPATCH_LEVEL