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 |
---|---|
|
Funzione completata. |
|
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 |