getTraceLoggerHandle 函式 (evntrace.h)

RegisterTraceGuids型 (「傳統」) 事件提供者會使用GetTraceLoggerHandle函式來擷取事件追蹤會話的控制碼，而事件追蹤會話應該寫入事件。

提供者會從其 ControlCallback 函式呼叫此函式。

語法

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

[in] Buffer

WNODE_HEADER結構的指標。 ETW 會將這個結構傳遞至Buffer參數中的提供者ControlCallback函式。

WNODE_HEADER的HistoricalCoNtext成員包含會話的控制碼。

如果函式成功，它會傳回事件追蹤會話控制碼。

如果函式失敗，它會傳回 INVALID_HANDLE_VALUE。若要取得擴充的錯誤資訊，請呼叫 GetLastError 函式。

呼叫 GetTraceEnableFlags 和 GetTraceEnableLevel 函式時，您可以使用控制碼來擷取傳遞至 EnableTrace 函式的啟用旗標和層級值。

如需使用 GetTraceLoggerHandle的範例，請參閱使用 MOF 擷取事件資料。


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