Função PdhSetCounterScaleFactor (pdh.h)

  • Artigo

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
PDH_INVALID_ARGUMENT
 O valor de escala está fora do intervalo.
PDH_INVALID_HANDLE
 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

Confira também

PdhCalculateCounterFromRawValue

PdhComputeCounterStatistics

PdhGetFormattedCounterValue