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

Статья
08/27/2023

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

Синтаксис

BOOL CommConfigDialogW(
  [in]      LPCWSTR      lpszName,
  [in]      HWND         hWnd,
  [in, out] LPCOMMCONFIG lpCC
);

Параметры

[in] lpszName

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

[in] hWnd

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

[in, out] lpCC

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

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

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

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

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

Требования


Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

COMMCONFIG

Функции связи

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

Share via