TraceLoggingRegisterEx 函式 (traceloggingprovider.h)

發行項
08/26/2023

註冊 TraceLogging 提供者，以便用來記錄事件，並指定 ETW 啟用回呼。註冊有效，直到提供者取消註冊或進程結束為止。

語法

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

參數

[in, out] hProvider

要註冊之 TraceLogging 提供者的控制碼。控制碼必須尚未註冊。

[in, optional] pEnableCallback

ETW 啟用回呼，會在追蹤會話啟用或停用您的提供者時叫用。

[in, optional] pCallbackContext

要傳遞至回呼的選擇性提供者定義內容指標。

傳回值

如果您從使用者模式程式碼呼叫此函式，函式會傳 HRESULT 回。 SUCCEEDED()使用宏來判斷函式是否成功。

如果您從核心模式程式碼呼叫此函式，函式會 NTSTATUS 傳回。 NT_SUCCESS()使用宏來判斷函式是否成功。

注意

TraceLoggingRegisterEx 傳回的錯誤碼主要用於偵錯和診斷案例。即使 ETW 提供者無法註冊，大部分的生產程式碼都應該繼續執行，因此發行組建通常應該忽略 TraceLoggingRegisterEx 傳回的錯誤碼。

備註

如需註冊提供者的詳細資訊，請參閱 TraceLoggingRegister 。如需回呼行為的詳細資訊，請參閱 ETW 啟用回呼。

TraceLoggingRegisterEx 會執行下列動作：

呼叫 EventRegister 以開啟 ETW 的連線。
如果EventRegister成功，請使用InformationClassEventProviderSetTraits呼叫TraceLoggingSetInformation來設定 TraceLogging 支援的提供者。

對TraceLoggingRegister的呼叫與回呼和內容參數的TraceLoggingRegisterEx呼叫相同。如果您需要在會話啟用或停用提供者時收到 ETW 啟用回呼，請使用 TraceLoggingRegisterEx 。

規格需求


最低支援的用戶端	Windows Vista [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2008 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	traceloggingprovider.h
程式庫	Advapi32.lib
Dll	N/A