OpenEventLogW-Funktion (winbase.h)

2024-11-20

Öffnet ein Handle für das angegebene Ereignisprotokoll.

Syntax

HANDLE OpenEventLogW(
  [in] LPCWSTR lpUNCServerName,
  [in] LPCWSTR lpSourceName
);

Parameter

[in] lpUNCServerName

Der Name der Universal Naming Convention (UNC) des Remoteservers, auf dem das Ereignisprotokoll geöffnet werden soll. Wenn dieser Parameter NULL-ist, wird der lokale Computer verwendet.

[in] lpSourceName

Der Name des Protokolls.

Wenn Sie ein benutzerdefiniertes Protokoll angeben und es nicht gefunden werden kann, öffnet der Ereignisprotokollierungsdienst das Application-Protokoll; Es gibt jedoch keine zugeordnete Nachrichten- oder Kategoriezeichenfolgendatei.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert das Handle für ein Ereignisprotokoll.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Um das Handle im Ereignisprotokoll zu schließen, verwenden Sie die CloseEventLog--Funktion.

Beispiele

Ein Beispiel finden Sie unter Abfragen von Ereignisinformationen.

Anmerkung

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