Freigeben über


ClearEventLogA-Funktion (winbase.h)

Löscht das angegebene Ereignisprotokoll und speichert optional die aktuelle Kopie des Protokolls in einer Sicherungsdatei.

Syntax

BOOL ClearEventLogA(
  [in] HANDLE hEventLog,
  [in] LPCSTR lpBackupFileName
);

Parameter

[in] hEventLog

Ein Handle für das zu löschende Ereignisprotokoll. Die OpenEventLog-Funktion gibt dieses Handle zurück.

[in] lpBackupFileName

Der absolute oder relative Pfad der Sicherungsdatei. Wenn diese Datei bereits vorhanden ist, schlägt die Funktion fehl.

Wenn der lpBackupFileName-ParameterNULL ist, wird das Ereignisprotokoll nicht gesichert.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die ClearEventLog-Funktion kann fehlschlagen, wenn das Ereignisprotokoll leer ist oder die Sicherungsdatei bereits vorhanden ist.

Hinweise

Nachdem diese Funktion zurückgegeben wurde, können alle Handles, die auf das gelöschte Ereignisprotokoll verweisen, nicht zum Lesen des Protokolls verwendet werden.

Hinweis

Der winbase.h-Header definiert ClearEventLog als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Advapi32.lib
DLL Advapi32.dll
APIs ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (eingeführt in Windows 10, Version 10.0.10240)

Weitere Informationen

Ereignisprotokollierungsfunktionen

OpenEventLog