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 错误代码。下面是可能的值。

返回代码	说明
PDH_INVALID_HANDLE	查询句柄无效。
PDH_INVALID_ARGUMENT	结束时间范围值必须大于起始时间范围值。

当到达指定时间范围的末尾或日志文件的末尾时， PdhCollectQueryData 函数将返回PDH_NO_MORE_DATA。