Função EvtClearLog (winevt.h)

Remove todos os eventos do canal especificado e os grava no arquivo de log de destino.

Sintaxe

BOOL EvtClearLog(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    ChannelPath,
  [in, optional] LPCWSTR    TargetFilePath,
  [in]           DWORD      Flags
);

Parâmetros

[in, optional] Session

Um identificador de sessão remota que a função EvtOpenSession retorna. Defina como NULL para canais locais.

[in] ChannelPath

O nome do canal a ser limpo.

[in, optional] TargetFilePath

O caminho completo para o arquivo de log de destino que receberá os eventos. Defina como NULL para limpar o arquivo de log e não salvar os eventos.

[in] Flags

Reservado. Deve ser zero.

Retornar valor

Valor/código retornado	Descrição
TRUE	A função foi bem-sucedida.
FALSE	A função falhou. Use a função GetLastError para obter o código de erro.

Comentários

Para copiar eventos de um canal ou arquivo de log, chame a função EvtExportLog .

Você deve especificar o caminho absoluto para o arquivo de log de destino; você não pode usar caminhos relativos e variáveis de ambiente para especificar o arquivo de log de destino. O caminho pode ser um caminho UNC (Convenção Universal de Nomenclatura). Você deve usar .evtx como a extensão de nome de arquivo.

Essa função afeta apenas o canal – se o canal usar autoBackup ou fileMax, essa função não afetará esses arquivos de backup.

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	winevt.h
Biblioteca	Wevtapi.lib
DLL	Wevtapi.dll

Confira também

EvtArchiveExportedLog

EvtExportLog