Condividi tramite


Funzione EvtClearLog (winevt.h)

Rimuove tutti gli eventi dal canale specificato e li scrive nel file di log di destinazione.

Sintassi

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

Parametri

[in, optional] Session

Handle di sessione remoto restituito dalla funzione EvtOpenSession . Impostare su NULL per i canali locali.

[in] ChannelPath

Nome del canale da cancellare.

[in, optional] TargetFilePath

Percorso completo del file di log di destinazione che riceverà gli eventi. Impostare su NULL per cancellare il file di log e non salvare gli eventi.

[in] Flags

Riservato. Deve essere zero.

Valore restituito

Codice/valore restituito Descrizione
TRUE
Funzione completata.
FALSE
La funzione non è riuscita. Usare la funzione GetLastError per ottenere il codice di errore.

Commenti

Per copiare gli eventi da un canale o un file di log, chiamare la funzione EvtExportLog .

È necessario specificare il percorso assoluto del file di log di destinazione; non è possibile usare percorsi relativi e variabili di ambiente per specificare il file di log di destinazione. Il percorso può essere un percorso UNC (Universal Naming Convention). È consigliabile usare .evtx come estensione del nome file.

Questa funzione influisce solo sul canale, se il canale usa autoBackup o fileMax, questa funzione non influisce sui file di backup.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winevt.h
Libreria Wevtapi.lib
DLL Wevtapi.dll

Vedi anche

EvtArchiveExportedLog

EvtExportLog