Função GetExplicitEntriesFromAclA (aclapi.h)

Artigo
08/22/2023

A função GetExplicitEntriesFromAcl recupera uma matriz de estruturas que descrevem as ACEs (entradas de controle de acesso ) em uma ACL ( lista de controle de acesso ).

Sintaxe

DWORD GetExplicitEntriesFromAclA(
  [in]  PACL               pacl,
  [out] PULONG             pcCountOfExplicitEntries,
  [out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);

Parâmetros

[in] pacl

Um ponteiro para uma estrutura de ACL da qual obter informações de ACE .

[out] pcCountOfExplicitEntries

Um ponteiro para uma variável que recebe o número de estruturas EXPLICIT_ACCESS retornadas na matriz pListOfExplicitEntries .

[out] pListOfExplicitEntries

Um ponteiro para uma variável que recebe um ponteiro para uma matriz de estruturas EXPLICIT_ACCESS que descrevem os ACEs na ACL. Se a função for bem-sucedida, você deverá chamar a função LocalFree para liberar o buffer retornado.

Retornar valor

Se a função for bem-sucedida, a função retornará ERROR_SUCCESS.

Se a função falhar, ela retornará um código de erro diferente de zero definido em WinError.h.

Comentários

Cada entrada na matriz de estruturas de EXPLICIT_ACCESS descreve as informações de controle de acesso de um ACE para um administrador. Um administrador pode ser um usuário, grupo ou programa (como um serviço windows).

Cada estrutura EXPLICIT_ACCESS especifica um conjunto de direitos de acesso e um sinalizador de modo de acesso que indica se o ACE permite, nega ou audita os direitos especificados.

Para uma DACL ( lista de controle de acesso discricionário ), o sinalizador de modo de acesso pode ser GRANT_ACCESS ou DENY_ACCESS. Para obter informações sobre esses valores, consulte ACCESS_MODE.

Para uma SACL ( lista de controle de acesso do sistema ), o sinalizador de modo de acesso pode ser SET_AUDIT_ACCESS, SET_AUDIT_FAILURE ou ambos. Para obter informações sobre esses valores, consulte ACCESS_MODE.

Observação

O cabeçalho aclapi.h define GetExplicitEntriesFromAcl como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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	aclapi.h
Biblioteca	Advapi32.lib
DLL	Advapi32.dll