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

Статья
08/27/2023

Задает конфигурацию по умолчанию для устройства связи.

Синтаксис

BOOL SetDefaultCommConfigA(
  [in] LPCSTR       lpszName,
  [in] LPCOMMCONFIG lpCC,
  [in] DWORD        dwSize
);

Параметры

[in] lpszName

Название устройства. Например, COM1–COM9 — последовательные порты, а LPT1–LPT9 — параллельные порты.

[in] lpCC

Указатель на структуру COMMCONFIG .

[in] dwSize

Размер структуры, на которую указывает lpCC, в байтах.

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

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

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

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

Требования

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

См. также

COMMCONFIG

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

Информационные ресурсы

GetDefaultCommConfig

Share via