OpenBackupEventLogA-Funktion (winbase.h)
Öffnet ein Handle für ein Sicherungsereignisprotokoll, das von der BackupEventLog--Funktion erstellt wurde.
Syntax
HANDLE OpenBackupEventLogA(
[in] LPCSTR lpUNCServerName,
[in] LPCSTR lpFileName
);
Parameter
[in] lpUNCServerName
Der Name der Universal Naming Convention (UNC) des Remoteservers, auf dem dieser Vorgang ausgeführt werden soll. Wenn dieser Parameter NULL-ist, wird der lokale Computer verwendet.
[in] lpFileName
Der vollständige Pfad der Sicherungsdatei.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Sicherungsereignisprotokoll.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn der Sicherungsdateiname einen Remoteserver angibt, muss der parameter lpUNCServerNameNULL-sein.
Wenn diese Funktion auf Windows Vista und späteren Computern verwendet wird, können nur Sicherungsereignisprotokolle geöffnet werden, die mit der funktion BackupEventLog auf Windows Vista und späteren Computern gespeichert wurden.
Anmerkung
Der winbase.h-Header definiert OpenBackupEventLog als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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) |