TraceLoggingRegisterEx-Funktion (traceloggingprovider.h)

Artikel
08/26/2023

Registriert einen TraceLogging-Anbieter, damit er zum Protokollieren von Ereignissen verwendet werden kann, wobei ein ETW-Aktivierungsrückruf angegeben wird. Die Registrierung ist gültig, bis der Anbieter nicht registriert ist oder der Prozess beendet wird.

Syntax

TLG_STATUS TraceLoggingRegisterEx(
  [in, out]      TraceLoggingHProvider hProvider,
  [in, optional] TLG_PENABLECALLBACK   pEnableCallback,
  [in, optional] PVOID                 pCallbackContext
);

Parameter

[in, out] hProvider

Das Handle des zu registrierenden TraceLogging-Anbieters. Das Handle darf noch nicht registriert sein.

[in, optional] pEnableCallback

ETW Enable Callback , der aufgerufen wird, wenn eine Ablaufverfolgungssitzung Ihren Anbieter aktiviert oder deaktiviert.

[in, optional] pCallbackContext

Optionaler vom Anbieter definierter Kontextzeiger, der an den Rückruf übergeben werden soll.

Rückgabewert

Wenn Sie diese Funktion aus Benutzermoduscode aufrufen, gibt die Funktion einen HRESULTzurück. Verwenden Sie das SUCCEEDED() Makro, um zu bestimmen, ob die Funktion erfolgreich ist.

Wenn Sie diese Funktion aus Kernelmoduscode aufrufen, gibt die Funktion einen NTSTATUSzurück. Verwenden Sie das NT_SUCCESS() Makro, um zu bestimmen, ob die Funktion erfolgreich ist.

Hinweis

Der von TraceLoggingRegisterEx zurückgegebene Fehlercode ist in erster Linie für die Verwendung in Debug- und Diagnoseszenarien vorgesehen. Der meiste Produktionscode sollte auch dann weiterhin ausgeführt werden, wenn sich ein ETW-Anbieter nicht registrieren konnte. Daher sollten Releasebuilds in der Regel den von TraceLoggingRegisterEx zurückgegebenen Fehlercode ignorieren.

Hinweise

Ausführliche Informationen zum Registrieren von Anbietern finden Sie unter TraceLoggingRegister . Ausführliche Informationen zum Rückrufverhalten finden Sie unter AKTIVIEREN des Rückrufs.

TraceLoggingRegisterEx führt Folgendes aus:

Ruft EventRegister auf, um die Verbindung mit ETW zu öffnen.
Wenn EventRegister erfolgreich ist, ruft TraceLoggingSetInformation mit InformationClassEventProviderSetTraits auf, um den Anbieter für die TraceLogging-Unterstützung zu konfigurieren.

Ein Aufruf von TraceLoggingRegister entspricht einem Aufruf von TraceLoggingRegisterEx mit NULL für die Rückruf - und Kontextparameter . Verwenden Sie TraceLoggingRegisterEx , wenn Sie einen ETW Enable Callback erhalten müssen, wenn Sitzungen Ihren Anbieter aktivieren oder deaktivieren.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	traceloggingprovider.h
Bibliothek	Advapi32.lib
DLL	Nicht zutreffend