Функция CommConfigDialogA (winbase.h)

Статья
11/20/2024

Отображает диалоговое окно конфигурации, предоставленной драйвером.

Синтаксис

BOOL CommConfigDialogA(
  [in]      LPCSTR       lpszName,
  [in]      HWND         hWnd,
  [in, out] LPCOMMCONFIG lpCC
);

Параметры

[in] lpszName

Имя устройства, для которого должно отображаться диалоговое окно. Например, COM1-COM9 являются последовательными портами и LPT1-LPT9 являются параллельными портами.

[in] hWnd

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

[in, out] lpCC

Указатель на структуру COMMCONFIG . Эта структура содержит начальные параметры диалогового окна перед вызовом и изменяет значения после вызова.

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

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

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

Замечания

Для функции CommConfigDialog требуется библиотека динамической компоновки (DLL), предоставляемая поставщиком оборудования связи.

Заметка

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

Требования

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

См. также

COMMCONFIG

функций связи

ресурсы связи

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