Função AuthzReportSecurityEvent (authz.h)

A função AuthzReportSecurityEvent gera uma auditoria de segurança para uma fonte de evento de segurança registrada.

A auditoria da categoria de evento de acesso ao objeto deve ser habilitada para a função AuthzReportSecurityEvent gerar uma auditoria de segurança. Os tipos de auditoria disponíveis são definidos na enumeração AUDIT_PARAM_TYPE .

Sintaxe

AUTHZAPI BOOL AuthzReportSecurityEvent(
  [in]           DWORD                                dwFlags,
  [in, out]      AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           DWORD                                dwCount,
                 ...                                  
);

Parâmetros

[in] dwFlags

Sinalizadores que especificam o tipo de auditoria gerada. A tabela a seguir mostra os valores possíveis.

Valor	Significado
APF_AuditFailure 0x00000000	Auditorias de falha são geradas.
APF_AuditSuccess 0x00000001	Auditorias de êxito são geradas.

[in, out] hEventProvider

Um identificador para a origem do evento de segurança registrada a ser usada para a auditoria.

[in] dwAuditId

O identificador da auditoria.

[in, optional] pUserSid

Um ponteiro para o SID ( identificador de segurança ) que será listado como a origem da auditoria no log de eventos.

[in] dwCount

O número de pares de tipo/valor AuditParamFlag que aparecem na seção argumentos de variável que segue esse parâmetro.

...

Uma lista de pares de tipo/valor AuditParamFlag que fornecem informações adicionais sobre o evento.

Retornar valor

Se a função for bem-sucedida, a função retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	authz.h
Biblioteca	Authz.lib
DLL	Authz.dll
Redistribuível	Pacote de Ferramentas de Administração do Windows Server 2003 no Windows XP

Confira também

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams