Freigeben über


OpenEventLogA-Funktion (winbase.h)

Ö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)

Weitere Informationen

ClearEventLog

CloseEventLog

Ereignisprotokollierungsfunktionen

Eventlog-Schlüssel

ReadEventLog

ReportEvent