Funzione PdhGetRawCounterValue (pdh.h)

Articolo
03/01/2024

Restituisce il valore non elaborato corrente del contatore.

Sintassi

PDH_FUNCTION PdhGetRawCounterValue(
  [in]  PDH_HCOUNTER     hCounter,
  [out] LPDWORD          lpdwType,
  [out] PPDH_RAW_COUNTER pValue
);

Parametri

[in] hCounter

Handle del contatore da cui recuperare il valore non elaborato corrente. La funzione PdhAddCounter restituisce questo handle.

[out] lpdwType

Riceve il tipo di contatore. Per un elenco dei tipi di contatori, vedere la sezione Tipi di contatore di Windows Server 2003 Deployment Kit. Questo parametro è facoltativo e,

[out] pValue

Struttura PDH_RAW_COUNTER che riceve il valore del contatore.

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
PDH_INVALID_ARGUMENT	Un parametro non è valido o non è formattato correttamente.
PDH_INVALID_HANDLE	L'handle del contatore non è valido.

Commenti

I dati per il contatore sono bloccati (protetti) per la durata della chiamata a PdhGetRawCounterValue per impedire modifiche durante l'elaborazione della chiamata.

Se l'istanza del contatore specificata non esiste, questa funzione restituirà ERROR_SUCCESS e il membro CStatus della struttura PDH_RAW_COUNTER conterrà PDH_CSTATUS_NO_INSTANCE.

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

Vedi anche

PdhCalculateCounterFromRawValue

PdhCollectQueryData

PdhGetFormattedCounterValue

Condividi tramite