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 版本。混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。