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;Windows 8 和 Windows Server 2012 上的Advapi32.dll

另請參閱

TRACE_QUERY_INFO_CLASS

TraceSetInformation