Функция PdhOpenQueryA (pdh.h)
Создает новый запрос, используемый для управления коллекцией данных производительности.
Чтобы использовать дескриптор для источников данных, используйте функцию PdhOpenQueryH.
Синтаксис
PDH_FUNCTION PdhOpenQueryA(
[in] LPCSTR szDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
Параметры
[in] szDataSource
строке null-terminated, указывающей имя файла журнала, из которого извлекаются данные о производительности. Если значение NULL, данные о производительности собираются из источника данных в режиме реального времени.
[in] dwUserData
Определяемое пользователем значение для связывания с этим запросом. Чтобы получить данные пользователя позже, вызовите PdhGetCounterInfo и получите доступ к элементу dwQueryUserDataPDH_COUNTER_INFO.
[out] phQuery
Обработка запроса. Этот дескриптор используется в последующих вызовах.
Возвращаемое значение
Если функция выполнена успешно, она возвращает ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение представляет собой код ошибки системы или код ошибки PDH.
Замечания
Заметка
Заголовок pdh.h определяет PdhOpenQuery как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | pdh.h |
| библиотеки |
Pdh.lib |
| DLL | Pdh.dll |