Función PdhSetCounterScaleFactor (pdh.h)

Establece el factor de escala que se aplica al valor calculado del contador especificado al solicitar el valor del contador con formato. Si se establece la marca PDH_FMT_NOSCALE, se omite este factor de escala.

Sintaxis

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

Parámetros

[in] hCounter

Identificador del contador al que se va a aplicar el factor de escala. La función PdhAddCounter devuelve este identificador.

[in] lFactor

Potencia de diez por la que multiplicar el valor calculado antes de devolverlo. El valor mínimo de este parámetro es PDH_MIN_SCALE (–7), donde el valor devuelto es el valor real multiplicado por 10^–⁷. El valor máximo de este parámetro es PDH_MAX_SCALE (+7), donde el valor devuelto es el valor real multiplicado por 10⁺⁷. Un valor de cero establecerá la escala en una, de modo que se devuelva el valor real.

Valor devuelto

Si la función se realiza correctamente, devuelve ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema o un código de error PDH. A continuación se muestran los valores posibles.

Código devuelto	Descripción
PDH_INVALID_ARGUMENT	El valor de escalado está fuera del intervalo.
PDH_INVALID_HANDLE	El identificador de contador no es válido.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	pdh.h
Library	Pdh.lib
Archivo DLL	Pdh.dll

Consulte también

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue