queryTraceProcessingHandle 函式 (evntrace.h)

擷取 OpenTrace所開啟之 ETW 追蹤處理會話的相關資訊。

語法

ETW_APP_DECLSPEC_DEPRECATED ULONG WMIAPI QueryTraceProcessingHandle(
  [in]            TRACEHANDLE                  ProcessingHandle,
  [in]            ETW_PROCESS_HANDLE_INFO_TYPE InformationClass,
  [in, optional]  PVOID                        InBuffer,
  [in]            ULONG                        InBufferSize,
  [out, optional] PVOID                        OutBuffer,
  [in]            ULONG                        OutBufferSize,
  [out]           PULONG                       ReturnLength
);

參數

[in] ProcessingHandle

使用 OpenTrace 建立的有效控制碼，應該從中查詢資料。

[in] InformationClass

ETW_PROCESS_HANDLE_INFO_TYPE值，指定控制碼上將執行的作業種類。

[in, optional] InBuffer

保留供未來使用。 可能是 Null。

[in] InBufferSize

以位元組為單位的 InBuffer大小。

[out, optional] OutBuffer

呼叫端提供的緩衝區，以接收輸出資料。

[in] OutBufferSize

以位元組為單位的 OutBuffer 大小。

[out] ReturnLength

API 寫入 OutBuffer的資料大小，以位元組為單位。 用於可變長度傳回。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值就是其中一個 系統錯誤碼。

需求

最低支援的用戶端	Windows 10 1709 版 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2016 [僅限傳統型應用程式]
目標平台	Windows
標頭	evntrace.h
程式庫	AdvAPI32.lib
Dll	AdvAPI32.dll