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


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

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

Чтобы использовать дескриптор для источников данных, используйте функцию PdhGetDataSourceTimeRangeH.

Синтаксис

PDH_FUNCTION PdhGetDataSourceTimeRangeA(
  [in]  LPCSTR         szDataSource,
  [out] LPDWORD        pdwNumEntries,
  [out] PPDH_TIME_INFO pInfo,
  [in]  LPDWORD        pdwBufferSize
);

Параметры

[in] szDataSource

Строка, завершающая значение NULL, указывающая имя файла журнала, из которого извлекаются сведения о диапазоне времени.

[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
Текущий источник данных — это источник данных в режиме реального времени.

Замечания

Заметка

Заголовок pdh.h определяет PdhGetDataSourceTimeRange как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows XP [только классические приложения]
минимальный поддерживаемый сервер Windows Server 2003 [только классические приложения]
целевая платформа Виндоус
заголовка pdh.h
библиотеки Pdh.lib
DLL Pdh.dll

См. также

PdhGetDataSourceTimeRangeH

PdhSetQueryTimeRange