OpenEventLogA-Funktion (winbase.h)

Artikel
08/27/2023

Öffnet ein Handle für das angegebene Ereignisprotokoll.

Syntax

HANDLE OpenEventLogA(
  [in] LPCSTR lpUNCServerName,
  [in] LPCSTR lpSourceName
);

Parameter

[in] lpUNCServerName

Der UNC-Name (Universal Naming Convention) 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, das nicht gefunden werden kann, öffnet der Ereignisprotokollierungsdienst das Anwendungsprotokoll . 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 bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Verwenden Sie die CloseEventLog-Funktion , um das Handle für das Ereignisprotokoll zu schließen.

Beispiele

Ein Beispiel finden Sie unter Abfragen von Ereignisinformationen.

Hinweis

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


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)