Função GetExplicitEntriesFromAclA (aclapi.h)
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 |