RtlGetAce routine

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

Syntax


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

Parameters

Acl [in]

Pointer to an ACL containing the ACE to be retrieved.

AceIndex [in]

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 [out]

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

Target platform

Universal

Version

This routine is available on Microsoft Windows XP and later.

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

 

 

Send comments about this topic to Microsoft

Show: