UnregisterTraceGuids 函式 (evntrace.h)

  • 發行項

UnregisterTraceGuids 函式會取消註冊使用 RegisterTraceGuids 註冊的傳統 (Windows 2000 樣式) ETW 事件追蹤提供者。

語法

ULONG WMIAPI UnregisterTraceGuids(
  [in] TRACEHANDLE RegistrationHandle
);

參數

[in] RegistrationHandle

處理事件追蹤提供者，從先前呼叫 RegisterTraceGuids 函式取得。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值就是其中一個 系統錯誤碼。 以下是一些常見的錯誤及其原因。

  • ERROR_INVALID_PARAMETER

    RegistrationHandle 參數未指定已註冊提供者的句柄，或為 NULL。

備註

提供者會呼叫此函式。

事件追蹤提供者先前必須藉由呼叫 RegisterTraceGuids 函式來註冊。

重要

DLL 或驅動程式所建立的所有註冊句柄都必須在 DLL 或驅動程式卸除之前取消註冊。 如果未取消註冊提供者，ETW 嘗試叫用提供者的回呼時，就會發生當機。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 evntrace.h
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

RegisterTraceGuids