共用方式為


pdhGetRawCounterValue 函式 (pdh.h)

傳回計數器目前的原始值。

語法

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

參數

[in] hCounter

要從中擷取目前原始值的計數器句柄。 PdhAddCounter 函式會傳回此句柄。

[out] lpdwType

接收計數器類型。 如需計數器類型的清單,請參閱 Windows Server 2003 部署套件的計數器類型一節。 這是選擇性參數。

[out] pValue

接收計數器值的 PDH_RAW_COUNTER 結構。

傳回值

如果函式成功,它會傳回ERROR_SUCCESS。

如果函式失敗,傳回值為 系統錯誤碼PDH 錯誤碼。 以下是可能的值。

傳回碼 Description
PDH_INVALID_ARGUMENT
參數無效或格式不正確。
PDH_INVALID_HANDLE
計數器句柄無效。

備註

計數器的數據會在呼叫 PdhGetRawCounterValue 期間鎖定 (受保護) ,以避免在處理呼叫期間發生任何變更。

如果指定的計數器實例不存在,此函式會傳回ERROR_SUCCESS,而 PDH_RAW_COUNTER 結構的 CStatus 成員將包含PDH_CSTATUS_NO_INSTANCE。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 pdh.h
程式庫 Pdh.lib
Dll Pdh.dll

另請參閱

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue