PerfOpenQueryHandle 函式 (perflib.h)

建立句柄，參考指定系統上的查詢。 查詢是計數器規格的清單。

語法

ULONG PerfOpenQueryHandle(
  [in, optional] LPCWSTR szMachine,
  [out]          HANDLE  *phQuery
);

參數

[in, optional] szMachine

您要取得查詢句柄的電腦名稱。

[out] phQuery

查詢的句柄。 呼叫 PerfCloseQueryHandle 以在您不再需要時關閉句柄。

傳回值

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

如果函式失敗，則傳回值是 系統錯誤碼。

備註

使用 PerfAddCounters 和 PerfDeleteCounters 將計數器規格新增或移除清單。 使用 PerfQueryCounterInfo 取得目前清單中的計數器規格，並判斷 PerfQueryCounterData 將傳回每個計數器數據的索引。 使用 PerfQueryCounterData 來擷取符合計數器規格的計數器值。

規格需求

另請參閱

PerfAddCounters

PerfCloseQueryHandle

PerfDeleteCounters

PerfQueryCounterData

PerfQueryCounterInfo