TraceQueryInformation 函式 （evntrace.h）

TraceQueryInformation 函式提供事件追蹤會話的相關資訊。

語法

ULONG WMIAPI TraceQueryInformation(
                  CONTROLTRACE_ID  TraceId,
  [in]            TRACE_INFO_CLASS InformationClass,
  [out]           PVOID            TraceInformation,
  [in]            ULONG            InformationLength,
  [out, optional] PULONG           ReturnLength
);

參數

TraceId

[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 之後呼叫此函式。

需求

另請參閱

TRACE_QUERY_INFO_CLASS

追蹤集資訊