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 por chamador para receber o endereço do ACE dentro da ACL.

Valor de retorno

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

Observações

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
de cliente com suporte mínimo Windows XP
da Plataforma de Destino Universal
cabeçalho ntifs.h (inclua Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe (modo kernel); Ntdll.dll (modo de usuário)
IRQL < DISPATCH_LEVEL

Consulte também

ACE

acl

rtlCreateAcl