PdhSetCounterScaleFactor 函式 (pdh.h)

設定當您要求格式化計數器值時，套用至指定計數器之計算值的縮放比例。如果已設定PDH_FMT_NOSCALE旗標，則會忽略此縮放比例。

語法

PDH_FUNCTION PdhSetCounterScaleFactor(
  [in] PDH_HCOUNTER hCounter,
  [in] LONG         lFactor
);

[in] hCounter

要套用縮放比例的計數器句柄。 PdhAddCounter 函式會傳回此句柄。

[in] lFactor

在傳回計算值之前，要乘以 10 的乘冪。此參數的最小值是PDH_MIN_SCALE (–7) ，其中傳回的值是實際值乘以 10^–⁷。此參數的最大值是PDH_MAX_SCALE (+7) ，其中傳回的值是實際值乘以 10⁺⁷。值為零會將小數字數設定為一，以便傳回實際值。

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

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

傳回碼	Description
PDH_INVALID_ARGUMENT	尺規值超出範圍。
PDH_INVALID_HANDLE	計數器句柄無效。