PdhOpenQueryA 函式（pdh.h）

建立用來管理效能數據收集的新查詢。

若要使用數據源的句柄，請使用 PdhOpenQueryH 函式。

語法

PDH_FUNCTION PdhOpenQueryA(
  [in]  LPCSTR     szDataSource,
  [in]  DWORD_PTR  dwUserData,
  [out] PDH_HQUERY *phQuery
);

[in] szDataSource

Null終止字串，指定要從中擷取效能數據的記錄檔名稱。如果 NULL，則會從實時數據源收集效能數據。

[in] dwUserData

要與此查詢產生關聯的使用者定義值。若要稍後擷取用戶數據，請呼叫 PdhGetCounterInfo，並存取 PDH_COUNTER_INFO的 dwQueryUserData 成員。

[out] phQuery

查詢的句柄。您可以在後續呼叫中使用這個句柄。

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

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

注意

pdh.h 標頭會將 PdhOpenQuery 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。