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

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

  • Статья

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

Синтаксис

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

[out] szDataSource

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

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

[in, out] pcchBufferLength

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

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

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

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

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

Комментарии

Примечание

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

Требования

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

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

PdhIsRealTimeQuery