Função PdhSetCounterScaleFactor (pdh.h)
Define o fator de escala aplicado ao valor calculado do contador especificado quando você solicita o valor do contador formatado. Se o sinalizador PDH_FMT_NOSCALE estiver definido, esse fator de escala será ignorado.
Sintaxe
PDH_FUNCTION PdhSetCounterScaleFactor(
[in] PDH_HCOUNTER hCounter,
[in] LONG lFactor
);
Parâmetros
[in] hCounter
Identificador do contador ao qual aplicar o fator de escala. A função PdhAddCounter retorna esse identificador.
[in] lFactor
Potência de dez pelo qual multiplicar o valor calculado antes de retorná-lo. O valor mínimo desse parâmetro é PDH_MIN_SCALE (-7), em que o valor retornado é o valor real multiplicado por 10–⁷. O valor máximo desse parâmetro é PDH_MAX_SCALE (+7), em que o valor retornado é o valor real multiplicado por 10⁺⁷. Um valor zero definirá a escala como um, de modo que o valor real seja retornado.
Retornar valor
Se a função for bem-sucedida, ela retornará ERROR_SUCCESS.
Se a função falhar, o valor retornado será um código de erro do sistema ou um código de erro PDH. Veja a seguir os valores possíveis.
| Código de retorno | Descrição |
|---|---|
|
O valor de escala está fora do intervalo. |
|
O identificador do contador não é válido. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | pdh.h |
| Biblioteca | Pdh.lib |
| DLL | Pdh.dll |