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

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

Confira também

EvtArchiveExportedLog

EvtExportLog