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