PdhSetQueryTimeRange 函式 (pdh.h)

限制您可以從記錄檔讀取到指定時間範圍內的範例，包括這些範例。

語法

PDH_FUNCTION PdhSetQueryTimeRange(
  [in] PDH_HQUERY     hQuery,
  [in] PPDH_TIME_INFO pInfo
);

[in] hQuery

查詢的句柄。 PdhOpenQuery 函式會傳回此句柄。

[in] pInfo

指定時間範圍的 PDH_TIME_INFO 結構。將時間指定為本機檔案時間。結束時間必須大於開始時間。如果您想要讀取所有記錄，您可以針對開始時間指定 0，以及結束時間的最大 64 位值。

如果函式成功，它會傳回ERROR_SUCCESS。

如果函式失敗，傳回值為系統錯誤碼或 PDH 錯誤碼。以下是可能的值。

傳回碼	Description
PDH_INVALID_HANDLE	查詢句柄無效。
PDH_INVALID_ARGUMENT	結束時間範圍值必須大於起始時間範圍值。

到達指定時間範圍的結尾或記錄檔結尾時， PdhCollectQueryData 函式會傳回PDH_NO_MORE_DATA。