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