Função GetExplicitEntriesFromAclA (aclapi.h)

Artigo
11/20/2024

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

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 ACE.

[out] pcCountOfExplicitEntries

Um ponteiro para uma variável que recebe o número de estruturas de 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.

Valor de retorno

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.

Observações

Cada entrada na matriz de estruturas de EXPLICIT_ACCESS descreve informações de controle de acesso de um ACE para um administrador. Um administrador pode ser um usuário, um grupo ou um 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 lista de controle de acesso discricionário (DACL), 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 lista de controle de acesso do sistema (SACL), 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [aplicativos da área de trabalho \| Aplicativos UWP]
servidor com suporte mínimo	Windows Server 2003 [aplicativos da área de trabalho \| Aplicativos UWP]
da Plataforma de Destino	Windows
cabeçalho	aclapi.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll