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 |