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 RegisterEventSourceW(
[in] LPCWSTR lpUNCServerName,
[in] LPCWSTR lpSourceName
);
Parameter
[in] lpUNCServerName
Der UNC-Name (Universal Naming Convention) 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 Registrierungsschlüssel Eventlog sein. Beachten Sie, dass das Sicherheitsprotokoll nur für die Systemverwendung vorgesehen ist.
Hinweis Diese Zeichenfolge darf keine Zeichen enthalten, die in XML-Attributen verboten sind, mit Ausnahme von XML-Escapesequenzen wie < oder >.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das Ereignisprotokoll.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Die Funktion gibt ERROR_ACCESS_DENIED zurück, wenn lpSourceName das Sicherheitsereignisprotokoll angibt.
Hinweise
Wenn der Quellname nicht gefunden werden kann, verwendet der Ereignisprotokollierungsdienst das Anwendungsprotokoll . Obwohl Ereignisse gemeldet werden, enthalten die Ereignisse keine Beschreibungen, da keine Nachrichten- und Kategorienachrichtendateien zum Suchen von Beschreibungen im Zusammenhang mit den Ereignisbezeichnern vorhanden sind.
Um das Handle mit dem Ereignisprotokoll zu schließen, verwenden Sie die Funktion DeregisterEventSource .
Beispiele
Ein Beispiel finden Sie unter Melden eines Ereignisses.
Hinweis
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 nicht codierungsneutralem Code 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 |
|---|---|
| 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 (einschließlich Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |
Weitere Informationen
RegistrierenEventSource aufheben