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)

Vedi anche

Funzioni di registrazione eventi

OpenEventLog