openCommPort 函数 (winbase.h)
尝试打开通信设备。
语法
HANDLE OpenCommPort(
[in] ULONG uPortNumber,
[in] DWORD dwDesiredAccess,
[in] DWORD dwFlagsAndAttributes
);
参数
[in] uPortNumber
通信设备要打开的从 1 开始的端口号。
[in] dwDesiredAccess
请求的设备访问权限。
有关请求的访问权限的详细信息,请参阅 CreateFile 和 Creating and Opening Files。
[in] dwFlagsAndAttributes
向设备请求的标志和属性。
注意
对于此函数,此参数仅应为 FILE_FLAG_OVERLAPPED 或 0x0 的值。
值 | 含义 |
---|---|
|
正在为异步 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 |