pdhCollectQueryData 函式 (pdh.h)
收集指定查詢中所有計數器的目前原始數據值，並更新每個計數器的狀態代碼。
語法
PDH_FUNCTION PdhCollectQueryData(
[in, out] PDH_HQUERY hQuery
);
參數
[in, out] hQuery
您要收集資料的查詢句柄。 PdhOpenQuery 函式會傳回這個句柄。
傳回值
如果函式成功，則會傳回ERROR_SUCCESS。 否則，函式會傳回 系統錯誤碼 或 PDH 錯誤碼。
以下是可能的值。
| 傳回碼 | Description |
|---|---|
|
查詢句柄無效。 |
|
查詢目前不包含任何計數器。 查詢可能不會包含數據，因為使用者未以提升許可權的令牌執行， (請參閱 有限的使用者存取支援) 。 |
備註
當您想要收集查詢中計數器的計數器數據時，請呼叫此函式。 PDH 會儲存目前和先前集合的原始計數器值。
如果您想要擷取目前的原始計數器值，請呼叫 PdhGetRawCounterValue 函式。 如果您想要計算計數器值的可顯示值，請呼叫 PdhGetFormattedCounterValue 函式。 如果計數器路徑包含實例名稱的通配符，請分別呼叫 PdhGetRawCounterArray 和 PdhGetFormattedCounterArray 函式。
只有一個計數器實例的數據呼叫 PdhCollectQueryData ，而且計數器實例不存在時，函式會傳回PDH_NO_DATA。 不過，如果查詢來自多個計數器的數據，即使其中一個計數器實例不存在， PdhCollectQueryData 仍可能會傳回ERROR_SUCCESS。 這是因為如果指定的計數器實例不存在，或它將會存在，但尚未建立，則未知。 在此情況下，請針對感興趣的每個計數器實例呼叫 PdhGetRawCounterValue 或 PdhGetFormattedCounterValue ，以判斷它們是否存在。
下列顯示從 Visual Basic 呼叫此函式時語法。
PdhCollectQueryData(
ByVal QueryHandle as Long
)
as Long
範例
如需範例，請參閱 流覽性能計數器 或 從記錄檔讀取效能數據。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | pdh.h |
| 程式庫 | Pdh.lib |
| Dll | Pdh.dll |