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.

Hinweis Diese Zeichenfolge darf keine Zeichen enthalten, die in XML-Attributen verboten sind, 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 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

Weitere Informationen

DeregisterEventSource

Ereignisprotokollierungsfunktionen

Ereignisquellen

ReportEvent