Função AuditSetSecurity (ntsecapi.h)

  • Artigo

A função AuditSetSecurity define um descritor de segurança que delega o acesso à política de auditoria.

Sintaxe

BOOLEAN AuditSetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parâmetros

[in] SecurityInformation

Um valor SECURITY_INFORMATION que especifica quais partes do descritor de segurança essa função define. Há suporte apenas para SACL_SECURITY_INFORMATION e DACL_SECURITY_INFORMATION . Todos os outros valores são ignorados. Se nem SACL_SECURITY_INFORMATION nem DACL_SECURITY_INFORMATION for especificado, essa função falhará e retornará ERROR_INVALID_PARAMETER.

[in] pSecurityDescriptor

Um ponteiro para uma estrutura de SECURITY_DESCRIPTOR bem formada que controla o acesso ao objeto de segurança Audit. Se esse parâmetro for NULL, a função falhará e retornará ERROR_INVALID_PARAMETER.

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.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecapi.h
Biblioteca Advapi32.lib
DLL Advapi32.dll

Confira também

AuditQuerySecurity