Função AuditSetGlobalSaclA (ntsecapi.h)

  • Artigo

A função AuditSetGlobalSacl define 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 AuditSetGlobalSaclA(
  [in]           PCSTR ObjectTypeName,
  [in, optional] 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 criado ou acessado. Para definir a SACL global em arquivos, isso deve ser definido como "Arquivo" e, para definir a SACL global no registro, isso deve ser definido como "Chave". Essa cadeia de caracteres aparece em qualquer mensagem de auditoria gerada pela função.

[in, optional] Acl

Um ponteiro para uma estrutura de ACL .

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
ERROR_ACCESS_DENIED
5
 O chamador não tem o privilégio ou os direitos de acesso necessários para chamar essa função.
ERROR_INVALID_PARAMETER
87
 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 AuditSetGlobalSacl 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 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