Share via

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

  • Статья

Пытается открыть устройство связи.

Синтаксис

HANDLE OpenCommPort(
  [in] ULONG uPortNumber,
  [in] DWORD dwDesiredAccess,
  [in] DWORD dwFlagsAndAttributes
);

Параметры

[in] uPortNumber

Один номер порта для открываемого устройства связи.

[in] dwDesiredAccess

Запрошенный доступ к устройству.

Дополнительные сведения о запрашиваемом доступе см. в разделах CreateFile и Create and Opening Files.

[in] dwFlagsAndAttributes

Запрошенные флаги и атрибуты устройства.

Примечание  

Для этой функции для этого параметра ожидаются только значения FILE_FLAG_OVERLAPPED или 0x0.

 
Значение Значение
FILE_FLAG_OVERLAPPED
0x40000000
 Файл или устройство открывается или создается для асинхронного ввода-вывода.

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

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

При возникновении ошибки функция возвращает INVALID_HANDLE_VALUE.

Комментарии

Параметр uPortNumber принимает однократные значения. Значение 1 для uPortNumber приводит к тому, что эта функция попытается открыть COM1.

Для поддержки UWP установите ссылку на WindowsApp.lib.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1709 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server версии 1709 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека OneCore.lib
DLL KernelBase.dll

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

CloseHandle

CreateFile

Создание и открытие файлов