RtlGetAce function

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

Syntax

NTSYSAPI NTSTATUS RtlGetAce(
  PACL  Acl,
  ULONG AceIndex,
  PVOID *Ace
);

Parameters

Acl

Pointer to an ACL containing the ACE to be retrieved.

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.

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 the documentation on these topics in the Microsoft Windows SDK.

Requirements

   
Windows version This routine is available on Microsoft Windows XP and later.
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