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] TRACEGUID_HANDLE 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 |