UnregisterTraceGuids-Funktion (evntrace.h)

Die UnregisterTraceGuids-Funktion hebt die Registrierung eines klassischen ETW-Ereignisablaufverfolgungsanbieters auf, der mit RegisterTraceGuids registriert wurde.

Syntax

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE RegistrationHandle
);

Parameter

[in] RegistrationHandle

Handle an den Ereignisablaufverfolgungsanbieter, der von einem früheren Aufruf der RegisterTraceGuids-Funktion abgerufen wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der Systemfehlercodes. Im Folgenden finden Sie einige häufige Fehler und deren Ursachen.

• ERROR_INVALID_PARAMETER

  Der Parameter RegistrationHandle gibt das Handle für einen registrierten Anbieter nicht an oder ist NULL.

Hinweise

Anbieter rufen diese Funktion auf.

Der Ereignisablaufverfolgungsanbieter muss zuvor durch Aufrufen der Funktion RegisterTraceGuids registriert worden sein.

Wichtig

Alle von einer DLL oder einem Treiber erstellten Registrierungshandles müssen vor dem Entladen der DLL oder des Treibers nicht registriert werden. Wenn die Registrierung des Anbieters nicht aufgehoben wird, tritt ein Absturz auf, wenn ETW versucht, den Rückruf des Anbieters aufzurufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	evntrace.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

RegisterTraceGuids