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 per il registro eventi da cancellare. La funzione OpenEventLog restituisce questo handle.
[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 informazioni dettagliate sull'errore, chiamare GetLastError. La funzione ClearEventLog può avere esito negativo se il registro eventi è vuoto o se il file di backup esiste già.
Commenti
Al termine della restituzione di questa funzione, non è possibile utilizzare tutti gli handle che fanno riferimento al registro eventi cancellato 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| 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) |