Поделиться через

Функция 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.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header pdh.h
Библиотека Pdh.lib
DLL Pdh.dll

См. также раздел

PdhCollectQueryData

PdhGetDataSourceTimeRange

PdhOpenQuery