Funzione PdhCollectQueryData (pdh.h)
Raccoglie il valore di dati non elaborato corrente per tutti i contatori nella query specificata e aggiorna il codice di stato di ogni contatore.
Sintassi
PDH_FUNCTION PdhCollectQueryData(
[in, out] PDH_HQUERY hQuery
);
Parametri
[in, out] hQuery
Gestire la query per cui si desidera raccogliere i dati. La funzione PdhOpenQuery restituisce questo handle.
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 |
|---|---|
|
L'handle di query non è valido. |
|
La query attualmente non contiene contatori. La query potrebbe non contenere dati perché l'utente non è in esecuzione con un token con privilegi elevati (vedere Supporto accesso utente limitato). |
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.
Se si vuole recuperare il valore del contatore non elaborato corrente, chiamare la funzione PdhGetRawCounterValue . Se si vuole calcolare un valore visualizzabile per il valore del contatore, chiamare la funzione PdhGetFormattedCounterValue . Se il percorso del contatore contiene un carattere jolly per il nome dell'istanza, chiamare rispettivamente le funzioni PdhGetRawCounterArray e PdhGetFormattedCounterArray .
Quando PdhCollectQueryData viene chiamato per i dati da un'istanza di contatore solo e l'istanza del contatore non esiste, la funzione restituisce PDH_NO_DATA. Tuttavia, se i dati di più contatori vengono sottoposti a query, PdhCollectQueryData può restituire ERROR_SUCCESS anche se una delle istanze del contatore non esiste ancora. Ciò avviene perché non è noto se l'istanza del contatore specificata non esiste o se esiste, ma non è ancora stata creata. In questo caso, chiamare PdhGetRawCounterValue o PdhGetFormattedCounterValue per ognuna delle istanze di contatore di interesse per determinare se esistono.
Di seguito viene illustrata la sintassi se si chiama questa funzione da Visual Basic.
PdhCollectQueryData(
ByVal QueryHandle as Long
)
as Long
Esempio
Per un esempio, vedere Esplorazione dei contatori delle prestazioni o lettura dei dati sulle prestazioni da un file di log.
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 |