pdhCollectQueryDataWithTime 函式 (pdh.h)

收集指定查詢中所有計數器的目前原始數據值，並更新每個計數器的狀態代碼。

語法

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

參數

[in, out] hQuery

您要收集資料的查詢句柄。 PdhOpenQuery 函式會傳回這個句柄。

[out] pllTimeStamp

擷取查詢中第一個計數器值的時間戳。 時間會指定為 FILETIME。

傳回值

如果函式成功，則會傳回ERROR_SUCCESS。 否則，函式會傳回 系統錯誤碼 或 PDH 錯誤碼。

以下是可能的值。

備註

當您想要收集查詢中計數器的計數器數據時，請呼叫此函式。 PDH 會儲存目前和先前集合的原始計數器值。

如果您想要擷取目前的原始計數器值，請呼叫 PdhGetRawCounterValue 函式。 如果您想要計算計數器值的可顯示值，請呼叫 PdhGetFormattedCounterValue。 如果計數器路徑包含實例名稱的通配符，請分別呼叫 PdhGetRawCounterArray 和 PdhGetFormattedCounterArray 函式。

只有一個計數器實例的數據呼叫 PdhCollectQueryDataEx ，而且計數器實例不存在時，函式會傳回PDH_NO_DATA。 不過，如果查詢來自多個計數器的數據，即使其中一個計數器實例不存在， PdhCollectQueryDataEx 仍可能會傳回ERROR_SUCCESS。 這是因為如果指定的計數器實例不存在，或它將會存在，但尚未建立，則未知。 在此情況下，請針對每個感興趣的計數器實例呼叫 PdhGetRawCounterValue 或 PdhGetFormattedCounterValue 函式，以判斷它們是否存在。

規格需求

另請參閱

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery