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

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

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

Синтаксис

PDH_FUNCTION PdhBrowseCountersA(
  [in] PPDH_BROWSE_DLG_CONFIG_A pBrowseDlgData
);

Параметры

[in] pBrowseDlgData

Структура PDH_BROWSE_DLG_CONFIG , задающая поведение диалогового окна.

Возвращаемое значение

Если функция завершается успешно, она возвращает ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой код системной ошибки или код ошибки PDH.

Комментарии

Обратите внимание, что диалоговое окно может возвращать PDH_DIALOG_CANCELLED, если параметр bSingleCounterPerDialog имеет значение FALSE и пользователь нажимает кнопку Закрыть , поэтому обработка ошибок будет учитывать это.

Сведения об использовании этой функции см. в разделе Счетчики просмотра.

Примеры

Пример см. в разделе Просмотр счетчиков производительности.

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	pdh.h
Библиотека	Pdh.lib
DLL	Pdh.dll

См. также раздел

CounterPathCallBack

PDH_BROWSE_DLG_CONFIG

PdhBrowseCountersH