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

Статья
11/20/2024

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

Синтаксис

PDH_FUNCTION PdhSelectDataSourceA(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPSTR   szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

Параметры

[in] hWndOwner

Владелец диалогового окна. Это может быть null, если нет владельца (рабочий стол становится владельцем).

[in] dwFlags

Диалоговые окна, которые будут отображаться для запроса источника данных. Этот параметр может быть одним из следующих значений.

Ценность	Значение
PDH_FLAGS_FILE_BROWSER_ONLY	Отображение только браузера файлов. Установите этот флаг, если вы хотите запрашивать только имя и расположение файла журнала.
0	Откроется диалоговое окно выбора источника данных. Диалоговое окно позволяет пользователю выбирать данные о производительности из файла журнала или источника в режиме реального времени. Если пользователь указал, что данные должны быть собраны из файла журнала, браузер файлов отображается для пользователя, чтобы указать имя и расположение файла журнала.

Ценность

Значение

PDH_FLAGS_FILE_BROWSER_ONLY

Отображение только браузера файлов. Установите этот флаг, если вы хотите запрашивать только имя и расположение файла журнала.

0

Откроется диалоговое окно выбора источника данных. Диалоговое окно позволяет пользователю выбирать данные о производительности из файла журнала или источника в режиме реального времени. Если пользователь указал, что данные должны быть собраны из файла журнала, браузер файлов отображается для пользователя, чтобы указать имя и расположение файла журнала.

[out] szDataSource

Выделенный вызывающим буфером, который получает null-завершенную строку, содержащую имя выбранного пользователем файла журнала. Имя файла журнала усечено до размера буфера, если буфер слишком мал.

Если пользователь выбрал источник в режиме реального времени, буфер пуст.

[in, out] pcchBufferLength

Максимальный размер буфера szDataSource в TCHARs.

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

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

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

Возвращаемый код	Описание
PDH_INVALID_ARGUMENT	Длина буфера, передаваемого в pcchBufferLength, не равна фактической длине буфера szDataSource.
PDH_MEMORY_ALLOCATION_FAILURE	Буфер нулевой длины был передан в параметре szDataSource.

Замечания

Заметка

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

Требования

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

См. также

PdhIsRealTimeQuery

Поделиться через