Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft ein registriertes Handle für das angegebene Ereignisprotokoll ab.
Syntax
HANDLE RegisterEventSourceA(
[in] LPCSTR lpUNCServerName,
[in] LPCSTR lpSourceName
);
Parameter
[in] lpUNCServerName
Der Name der Universal Naming Convention (UNC) des Remoteservers, auf dem dieser Vorgang ausgeführt werden soll. Wenn dieser Parameter NULL-ist, wird der lokale Computer verwendet.
[in] lpSourceName
Der Name der Ereignisquelle, deren Handle abgerufen werden soll. Der Quellname muss ein Unterschlüssel eines Protokolls unter dem Eventlog Registrierungsschlüssel sein. Beachten Sie, dass das Security-Protokoll nur für die Systemverwendung vorgesehen ist.
Hinweis Diese Zeichenfolge darf in XML-Attributen keine Zeichen enthalten, mit Ausnahme von XML-Escapesequenzen wie < &gl.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Ereignisprotokoll.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Die Funktion gibt ERROR_ACCESS_DENIED zurück, wenn lpSourceName- das Security-Ereignisprotokoll angibt.
Bemerkungen
Wenn der Quellname nicht gefunden werden kann, verwendet der Ereignisprotokollierungsdienst das Application-Protokoll. Obwohl Ereignisse gemeldet werden, enthalten die Ereignisse keine Beschreibungen, da keine Nachrichten- und Kategorienachrichtendateien zum Suchen nach Beschreibungen im Zusammenhang mit den Ereignisbezeichnern vorhanden sind.
Um das Handle im Ereignisprotokoll zu schließen, verwenden Sie die funktion DeregisterEventSource.
Beispiele
Ein Beispiel finden Sie unter Melden eines Ereignis-.
Anmerkung
Der winbase.h-Header definiert RegisterEventSource 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 |