Функция PdhGetDataSourceTimeRangeH (pdh.h)

Статья
03/01/2024

Определяет диапазон времени, количество записей и, если применимо, размер буфера, содержащего данные о производительности из указанного источника входных данных.

Эта функция идентична функции PdhGetDataSourceTimeRange , за исключением того, что она поддерживает использование дескрипторов для источников данных.

Синтаксис

PDH_FUNCTION PdhGetDataSourceTimeRangeH(
  [in]  PDH_HLOG       hDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Параметры

[in] hDataSource

Дескриптор источника данных, возвращаемого функцией PdhBindInputDataSource .

[out] pdwNumEntries

Количество структур в буфере pInfo . Эта функция собирает сведения только за один диапазон времени, поэтому значение обычно равно 1 или нулю, если произошла ошибка.

[out] pInfo

Структура PDH_TIME_INFO , которая получает диапазон времени. Эти сведения охватывают все связанные файлы журнала.

[in] pdwBufferSize

Размер структуры PDH_TIME_INFO в байтах.

Возвращаемое значение

Если функция завершается успешно, она возвращает ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой код системной ошибки или код ошибки PDH. Ниже приведены возможные значения.

Код возврата	Описание
PDH_INVALID_ARGUMENT	Параметр недопустим или неправильно отформатирован.
PDH_INVALID_HANDLE	Недопустимый дескриптор счетчика.
PDH_DATA_SOURCE_IS_REAL_TIME	Текущий источник данных является источником данных в режиме реального времени.

Требования

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

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

PdhBindInputDataSource

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