PdhOpenQueryH 函式 (pdh.h)

建立用來管理效能資料收集的新查詢。

此函式與 PdhOpenQuery 函式相同，不同之處在于它支援對資料來源使用控制碼。

語法

PDH_FUNCTION PdhOpenQueryH(
  [in]  PDH_HLOG   hDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

[in] hDataSource

PdhBindInputDataSource函式所傳回之資料來源的控制碼。

[in] dwUserData

要與此查詢建立關聯的使用者定義值。若要稍後擷取使用者資料，請呼叫PdhGetCounterInfo函式，並存取PDH_COUNTER_INFO的dwQueryUserData成員。

[out] phQuery

查詢的控制碼。您可以在後續呼叫中使用這個控制碼。

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

如果函式失敗，傳回值為系統錯誤碼或 PDH 錯誤碼。