Função GetAclInformation (securitybaseapi.h)

Artigo
03/01/2024

A função GetAclInformation recupera informações sobre uma ACL ( lista de controle de acesso ).

Sintaxe

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

Parâmetros

[in] pAcl

Um ponteiro para uma ACL. A função recupera informações sobre essa ACL. Se um valor nulo for passado, a função causará uma violação de acesso.

[out] pAclInformation

Um ponteiro para um buffer para receber as informações solicitadas. A estrutura colocada no buffer depende da classe de informações solicitada no parâmetro dwAclInformationClass .

[in] nAclInformationLength

O tamanho, em bytes, do buffer apontado pelo parâmetro pAclInformation .

[in] dwAclInformationClass

Um valor da enumeração ACL_INFORMATION_CLASS que indica a classe de informações solicitadas. Esse parâmetro pode ser um dos dois valores dessa enumeração:

Se o valor for AclRevisionInformation, a função preencherá o buffer apontado pelo parâmetro pAclInformation com uma estrutura ACL_REVISION_INFORMATION .
Se o valor for AclSizeInformation, a função preencherá o buffer apontado pelo parâmetro pAclInformation com uma estrutura ACL_SIZE_INFORMATION .

Retornar valor

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

Requisito	Valor
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