Compartilhar via


Função RtlGetAce (ntifs.h)

A rotina RtlGetAce obtém um ponteiro para uma ACE (entrada de controle de acesso) em uma ACL (lista de controle de acesso).

Sintaxe

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

Parâmetros

[in] Acl

Ponteiro para uma ACL que contém o ACE a ser recuperado.

[in] AceIndex

Especifica o ACE ao qual um ponteiro é recuperado. Um valor zero corresponde ao primeiro ACE na ACL, 1 ao segundo ACE e assim por diante.

[out] Ace

Ponteiro para uma variável alocada pelo chamador para receber o endereço do ACE dentro da ACL.

Retornar valor

RtlGetAce retorna STATUS_SUCCESS ou um erro status código, como STATUS_INVALID_PARAMETER.

Comentários

Para obter mais informações sobre segurança e controle de acesso, consulte Modelo de segurança do Windows para desenvolvedores de driver e a documentação sobre esses tópicos no SDK do Windows.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL < DISPATCH_LEVEL

Confira também

ACE

ACL

RtlCreateAcl