Funzione PdhSetCounterScaleFactor (pdh.h)
Imposta il fattore di scala applicato al valore calcolato del contatore specificato quando si richiede il valore del contatore formattato. Se il flag di PDH_FMT_NOSCALE è impostato, questo fattore di scala viene ignorato.
Sintassi
PDH_FUNCTION PdhSetCounterScaleFactor(
[in] PDH_HCOUNTER hCounter,
[in] LONG lFactor
);
Parametri
[in] hCounter
Handle del contatore per applicare il fattore di scala a. La funzione PdhAddCounter restituisce questo handle.
[in] lFactor
Potenza di dieci per cui moltiplicare il valore calcolato prima di restituirlo. Il valore minimo di questo parametro è PDH_MIN_SCALE (–7), dove il valore restituito è il valore effettivo moltiplicato per 10-⁷. Il valore massimo di questo parametro è PDH_MAX_SCALE (+7), dove il valore restituito è il valore effettivo moltiplicato per 10⁺⁷. Un valore pari a zero imposta la scala su uno, in modo che venga restituito il valore effettivo.
Valore restituito
Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema o un codice di errore PDH. Di seguito sono riportati i valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Il valore di scala non è compreso nell'intervallo. |
|
L'handle del contatore non è valido. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | pdh.h |
| Libreria | Pdh.lib |
| DLL | Pdh.dll |