Compartilhar via


Função GetAce (securitybaseapi.h)

A função GetAce obtém um ponteiro para uma ACE ( entrada de controle de acesso ) em uma ACL (lista de controle de acesso ).

Sintaxe

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

Parâmetros

[in] pAcl

Um ponteiro para uma ACL que contém a ACE a ser recuperada.

[in] dwAceIndex

O índice da ACE a ser recuperada. Um valor zero corresponde ao primeiro ACE na ACL, um valor de um para o segundo ACE e assim por diante.

[out] pAce

Um ponteiro para um ponteiro que a função define como o endereço da ACE.

Valor retornado

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho securitybaseapi.h (inclua Windows.h)
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

Controle de Acesso de baixo nível

Funções de Controle de Acesso de baixo nível