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

Статья
08/25/2023

Создает новый запрос, который используется для управления сбором данных о производительности.

Чтобы использовать дескрипторы для источников данных, используйте функцию 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