Функция 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, если bSingleCounterPerDialogFALSE, а пользователь нажимает кнопку Закрыть, поэтому для обработки ошибок потребуется учесть это.

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

Примеры

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	pdh.h
библиотеки	Pdh.lib
DLL	Pdh.dll

См. также

CounterPathCallBack

PDH_BROWSE_DLG_CONFIG

PdhBrowseCountersH