BackupEventLogA-Funktion (winbase.h)
Speichert das angegebene Ereignisprotokoll in einer Sicherungsdatei. Die Funktion löscht das Ereignisprotokoll nicht.
Syntax
BOOL BackupEventLogA(
[in] HANDLE hEventLog,
[in] LPCSTR lpBackupFileName
);
Parameter
[in] hEventLog
Ein Handle für das geöffnete Ereignisprotokoll. Die OpenEventLog--Funktion gibt dieses Handle zurück.
[in] lpBackupFileName
Der absolute oder relative Pfad der Sicherungsdatei.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Die BackupEventLog--Funktion schlägt mit dem ERROR_PRIVILEGE_NOT_HELD Fehler fehl, wenn der Benutzer nicht über die SE_BACKUP_NAME Berechtigungen verfügt.
Anmerkung
Der winbase.h-Header definiert BackupEventLog 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
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |
| API-Satz | ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (eingeführt in Windows 10, Version 10.0.10240) |