共用方式為


getTraceLoggerHandle 函式 (evntrace.h)

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

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

語法

TRACEHANDLE WMIAPI GetTraceLoggerHandle(
  [in] PVOID Buffer
);

參數

[in] Buffer

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

WNODE_HEADERHistoricalCoNtext成員包含會話的控制碼。

傳回值

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

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

備註

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

範例

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

需求

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

另請參閱

GetTraceEnableFlags

GetTraceEnableLevel