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
PDH_INVALID_HANDLE	Das Abfragehandle ist ungültig.
PDH_INVALID_ARGUMENT	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

Weitere Informationen

PdhCollectQueryData

PdhGetDataSourceTimeRange

PdhOpenQuery