Funzione PdhCollectQueryDataWithTime (pdh.h)

Articolo
03/08/2023

Raccoglie il valore dei dati non elaborati corrente per tutti i contatori nella query specificata e aggiorna il codice di stato di ogni contatore.

Sintassi

PDH_FUNCTION PdhCollectQueryDataWithTime(
  [in, out] PDH_HQUERY hQuery,
  [out]     LONGLONG   *pllTimeStamp
);

Parametri

[in, out] hQuery

Handle della query per cui si desidera raccogliere i dati. La funzione PdhOpenQuery restituisce questo handle.

[out] pllTimeStamp

Timestamp quando è stato recuperato il primo valore del contatore nella query. L'ora viene specificata come FILETIME.

Valore restituito

Se la funzione ha esito positivo, restituisce ERROR_SUCCESS. In caso contrario, la funzione restituisce un codice di errore di sistema o un codice di errore PDH.

Di seguito sono riportati i valori possibili.

Codice restituito	Descrizione
PDH_INVALID_HANDLE	L'handle di query non è valido.
PDH_NO_DATA	La query non dispone attualmente di contatori.

Commenti

Chiamare questa funzione quando si desidera raccogliere i dati dei contatori per i contatori nella query. PDH archivia i valori dei contatori non elaborati per la raccolta corrente e precedente.

Per recuperare il valore corrente del contatore non elaborato, chiamare la funzione PdhGetRawCounterValue . Per calcolare un valore visualizzabile per il valore del contatore, chiamare PdhGetFormattedCounterValue. Se il percorso del contatore contiene un carattere jolly per il nome dell'istanza, chiamare rispettivamente le funzioni PdhGetRawCounterArray e PdhGetFormattedCounterArray .

Quando PdhCollectQueryDataEx viene chiamato per i dati solo da un'istanza del contatore e l'istanza del contatore non esiste, la funzione restituisce PDH_NO_DATA. Tuttavia, se viene eseguita una query sui dati di più contatori, PdhCollectQueryDataEx può restituire ERROR_SUCCESS anche se una delle istanze del contatore non esiste ancora. Ciò è dovuto al fatto che non è noto se l'istanza del contatore specificata non esiste o se esiste ma non è ancora stata creata. In questo caso, chiamare la funzione PdhGetRawCounterValue o PdhGetFormattedCounterValue per ognuna delle istanze del contatore di interesse per determinare se esistono.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	pdh.h
Libreria	Pdh.lib
DLL	Pdh.dll

Vedi anche

PdhCollectQueryData

PdhGetFormattedCounterValue

PdhGetRawCounterValue

PdhOpenQuery

Condividi tramite