Funzione PdhSetQueryTimeRange (pdh.h)
Limita gli esempi che è possibile leggere da un file di log a quelli inclusi nell'intervallo di tempo specificato, inclusi.
Sintassi
PDH_FUNCTION PdhSetQueryTimeRange(
[in] PDH_HQUERY hQuery,
[in] PPDH_TIME_INFO pInfo
);
Parametri
[in] hQuery
Handle per la query. La funzione PdhOpenQuery restituisce questo handle.
[in] pInfo
Struttura PDH_TIME_INFO che specifica l'intervallo di tempo. Specificare l'ora come ora del file locale. L'ora di fine deve essere maggiore dell'ora di inizio. È possibile specificare 0 per l'ora di inizio e il valore massimo a 64 bit per l'ora di fine se si desidera leggere tutti i record.
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 |
|---|---|
|
L'handle di query non è valido. |
|
Il valore dell'intervallo di tempo finale deve essere maggiore del valore dell'intervallo di tempo iniziale. |
Commenti
Quando viene raggiunta la fine dell'intervallo di tempo specificato o la fine del file di log, la funzione PdhCollectQueryData restituirà PDH_NO_MORE_DATA.
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 |