共用方式為

pdhCollectQueryData 函式 (pdh.h)

  • 發行項

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

語法

PDH_FUNCTION PdhCollectQueryData(
  [in, out] PDH_HQUERY hQuery
);

參數

[in, out] hQuery

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

傳回值

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

以下是可能的值。

傳回碼 Description
PDH_INVALID_HANDLE
 查詢句柄無效。
PDH_NO_DATA
 查詢目前不包含任何計數器。 查詢可能不會包含數據，因為使用者未以提升許可權的令牌執行， (請參閱 有限的使用者存取支援) 。

備註

當您想要收集查詢中計數器的計數器數據時，請呼叫此函式。 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

另請參閱

PdhGetFormattedCounterValue

PdhGetRawCounterValue