PdhSetQueryTimeRange-Funktion (pdh.h)
Schränkt die Beispiele, die Sie aus einer Protokolldatei lesen können, auf diejenigen innerhalb des angegebenen Zeitbereichs ein, einschließlich.
Syntax
PDH_FUNCTION PdhSetQueryTimeRange(
[in] PDH_HQUERY hQuery,
[in] PPDH_TIME_INFO pInfo
);
Parameter
[in] hQuery
Handle mit der Abfrage. Die PdhOpenQuery-Funktion gibt dieses Handle zurück.
[in] pInfo
Eine PDH_TIME_INFO-Struktur , die den Zeitbereich angibt. Geben Sie die Uhrzeit als lokale Dateizeit an. Die Endzeit muss größer als die Startzeit sein. Sie können 0 für die Startzeit und den maximalen 64-Bit-Wert für die Endzeit angeben, wenn Sie alle Datensätze lesen möchten.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.
Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Abfragehandle ist ungültig. |
|
Der Wert des Endzeitbereichs muss größer als der Wert des Startzeitbereichs sein. |
Hinweise
Wenn das Ende des angegebenen Zeitbereichs oder das Ende der Protokolldatei erreicht ist, gibt die PdhCollectQueryData-Funktion PDH_NO_MORE_DATA zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | pdh.h |
| Bibliothek | Pdh.lib |
| DLL | Pdh.dll |