openCommPort 函数 (winbase.h)

尝试打开通信设备。

语法

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

参数

[in] uPortNumber

通信设备要打开的从 1 开始的端口号。

[in] dwDesiredAccess

请求的设备访问权限。

有关请求的访问权限的详细信息,请参阅 CreateFileCreating and Opening Files

[in] dwFlagsAndAttributes

向设备请求的标志和属性。

注意  

对于此函数,此参数仅应为 FILE_FLAG_OVERLAPPED 或 0x0 的值。

 
含义
FILE_FLAG_OVERLAPPED
0x40000000
正在为异步 I/O 打开或创建文件或设备。

返回值

如果函数成功,该函数将返回有效的 HANDLE。 使用 CloseHandle 关闭该句柄。

如果发生错误,该函数将返回 INVALID_HANDLE_VALUE

注解

uPortNumber 参数接受从 1 开始的值。 uPortNumber 的值为 1 会导致此函数尝试打开 COM1。

若要支持 UWP,请针对 WindowsApp.lib 链接。

要求

要求
最低受支持的客户端 Windows 10版本 1709 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 版本 1709 [桌面应用 |UWP 应用]
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library OneCore.lib
DLL KernelBase.dll

另请参阅

CloseHandle

CreateFile

创建和打开文件