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。