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
);

Parameters

[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.

Return value

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

Remarks

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.

Requirements

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

See also

ACE

ACL

RtlCreateAcl