TraceQueryInformation 函式 (evntrace.h)
TraceQueryInformation 函式提供事件追蹤會話的相關信息。
語法
ULONG WMIAPI TraceQueryInformation(
[in] TRACEHANDLE SessionHandle,
[in] TRACE_INFO_CLASS InformationClass,
[out] PVOID TraceInformation,
[in] ULONG InformationLength,
[out, optional] PULONG ReturnLength
);
參數
[in] SessionHandle
您要收集資訊的事件追蹤會話句柄。
StartTrace 函式會在啟動新的追蹤時傳回此句柄。 若要取得現有追蹤的句柄,請使用 ControlTrace 根據追蹤的名稱查詢追蹤屬性,然後從傳EVENT_TRACE_PROPERTIES
回數據的 Wnode.HistoricalContext 欄位取得句柄。
[in] InformationClass
要查詢的信息類別。 類別擷取的資訊包含在事件的擴充數據區段中。 如需您可以查詢的信息類別清單,請參閱 TRACE_QUERY_INFO_CLASS 列舉。
[out] TraceInformation
緩衝區的指標,可接收傳回的信息類別特定數據。 資訊類別會決定此參數的內容。 例如,針對 TraceStackTracingInfo 資訊類別,此參數是 CLASSIC_EVENT_ID 結構的陣列。 結構會指定啟用堆疊追蹤的事件 GUID。 數位限制為256個元素。
[in] InformationLength
TraceInformation 緩衝區中傳回之數據的大小,以位元組為單位。 如果函式失敗,這個值表示所需的 TraceInformation 緩衝區大小。
[out, optional] ReturnLength
指標,這個值會接收 TraceInformation 緩衝區中傳回之特定數據的大小,以位元組為單位。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,傳回值就是下列其中一個錯誤碼。
ERROR_BAD_LENGTH
程序發出命令,但命令長度不正確。 如果 InformationLength 參數小於最小大小,就會傳回此錯誤。
ERROR_INVALID_PARAMETER
參數錯誤。
ERROR_NOT_SUPPORTED
不支援此要求。
其他
使用 FormatMessage 取得傳回錯誤的訊息字串。
備註
TraceQueryInformation 函式會從追蹤會話查詢事件追蹤會話設定。 呼叫 StartTrace 之後呼叫此函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | evntrace.h |
程式庫 | Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.lib;Windows 8 和 Windows Server 2012 上的 Advapi32.lib |
Dll | Windows 8.1 和 Windows Server 2012 R2 上的 Sechost.dll;Advapi32.dll Windows 8 和 Windows Server 2012 |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應