Функция 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
Количество структур в буфере
[out] pInfo
Структура PDH_TIME_INFO, которая получает диапазон времени.
[in] pdwBufferSize
Размер структуры PDH_TIME_INFO в байтах.
Возвращаемое значение
Если функция выполнена успешно, она возвращает ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение представляет собой код ошибки системы или код ошибки PDH. Ниже приведены возможные значения.
Возвращаемый код | Описание |
---|---|
|
Недопустимый параметр или неправильно отформатирован. |
|
Недопустимый дескриптор счетчика. |
|
Текущий источник данных — это источник данных в режиме реального времени. |
Замечания
Заметка
Заголовок pdh.h определяет PdhGetDataSourceTimeRange как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
целевая платформа | Виндоус |
заголовка | pdh.h |
библиотеки |
Pdh.lib |
DLL | Pdh.dll |