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 |
|---|---|
|
El valor de escalado está fuera del intervalo. |
|
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 |