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