Funzione ClearEventLogA (winbase.h)
Cancella il registro eventi specificato e, facoltativamente, salva la copia corrente del log in un file di backup.
Sintassi
BOOL ClearEventLogA(
[in] HANDLE hEventLog,
[in] LPCSTR lpBackupFileName
);
Parametri
[in] hEventLog
Handle del registro eventi da cancellare. La funzione OpenEventLog
[in] lpBackupFileName
Percorso assoluto o relativo del file di backup. Se il file esiste già, la funzione ha esito negativo.
Se il parametro lpBackupFileName è NULL, il registro eventi non viene sottoposto a backup.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError. La funzione ClearEventLog può non riuscire se il registro eventi è vuoto o se il file di backup esiste già.
Osservazioni
Al termine di questa funzione, gli handle che fanno riferimento al registro eventi cancellato non possono essere utilizzati per leggere il log.
Nota
L'intestazione winbase.h definisce ClearEventLog come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 2000 Professional [solo app desktop] |
| server minimo supportato | Windows 2000 Server [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
winbase.h (include Windows.h) |
| libreria |
Advapi32.lib |
| dll | Advapi32.dll |
| set di API | ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (introdotto in Windows 10, versione 10.0.10240) |