Função AuditQueryGlobalSaclA (ntsecapi.h)
A função AuditQueryGlobalSacl recupera uma SACL ( lista de controle de acesso do sistema ) global que delega o acesso às mensagens de auditoria. A atualização da SACL global requer o SeSecurityPrivilege , que protege a SACL global de ser atualizada por qualquer usuário sem privilégios de administrador.
Sintaxe
BOOLEAN AuditQueryGlobalSaclA(
[in] PCSTR ObjectTypeName,
[out] PACL *Acl
);
Parâmetros
[in] ObjectTypeName
Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o tipo de objeto que está sendo acessado. Esse parâmetro deve ser "File" ou "Key", dependendo se o objeto é um arquivo ou registro. Essa cadeia de caracteres aparece em qualquer mensagem de auditoria gerada pela função.
[out] Acl
Um ponteiro para uma estrutura de ACL que contém as informações da SACL. Isso deve ser liberado posteriormente chamando a função LocalFree .
Retornar valor
Se a função for bem-sucedida, ela retornará TRUE.
Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError. GetLastError pode retornar um dos seguintes códigos de erro definidos em WinError.h.
Valor/código retornado | Descrição |
---|---|
|
O chamador não tem o privilégio ou os direitos de acesso necessários para chamar essa função. |
|
Um ou mais parâmetros são inválidos. |
Comentários
Para chamar essa função com êxito, o chamador deve ter SeSecurityPrivilege.
Observação
O cabeçalho ntsecapi.h define AuditQueryGlobalSacl 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. 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 7 [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2008 R2 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | ntsecapi.h |
Biblioteca | Advapi32.lib |
DLL | Advapi32.dll |