Função SetAclInformation (securitybaseapi.h)

Artigo
08/25/2023

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

Sintaxe

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

Parâmetros

[in, out] pAcl

Um ponteiro para uma ACL. A função define informações nesta ACL.

[in] pAclInformation

Um ponteiro para um buffer que contém as informações a serem definidas. Isso deve ser um ponteiro para uma estrutura ACL_REVISION_INFORMATION .

[in] nAclInformationLength

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

[in] dwAclInformationClass

Um ACL_INFORMATION_CLASS tipo enumerado que fornece a classe de informações solicitadas.

Atualmente, esse parâmetro pode ser AclRevisionInformation. Isso significa que o buffer apontado pelo parâmetro pAclInformation contém uma estrutura ACL_REVISION_INFORMATION .

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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll