RegisterEventSourceA-Funktion (winbase.h)
Ruft ein registriertes Handle für das angegebene Ereignisprotokoll ab.
Syntax
HANDLE RegisterEventSourceA(
[in] LPCSTR lpUNCServerName,
[in] LPCSTR 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.
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.
Verwenden Sie die Funktion DeregisterEventSource , um das Handle für das Ereignisprotokoll zu schließen.
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 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 |
|---|---|
| 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 |