UnregisterTraceGuids 函式 (evntrace.h)
UnregisterTraceGuids 函式會取消註冊使用 RegisterTraceGuids 註冊的傳統 (Windows 2000 樣式) ETW 事件追蹤提供者。
語法
ULONG WMIAPI UnregisterTraceGuids(
[in] TRACEGUID_HANDLE 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 |