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