Freigeben über

OpenBackupEventLogA-Funktion (winbase.h)

  • Artikel

Ö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 UNC-Name (Universal Naming Convention) 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 bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn der Sicherungsdateiname einen Remoteserver angibt, muss der lpUNCServerName-ParameterNULL sein.

Wenn diese Funktion unter Windows Vista und späteren Computern verwendet wird, können nur Sicherungsereignisprotokolle geöffnet werden, die mit der BackupEventLog-Funktion unter Windows Vista und späteren Computern gespeichert wurden.

Hinweis

Der winbase.h-Header definiert OpenBackupEventLog 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
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

BackupEventLog

Ereignisprotokollierungsfunktionen