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 |