openCommPort 函式 (winbase.h)
嘗試開啟通訊裝置。
語法
HANDLE OpenCommPort(
[in] ULONG uPortNumber,
[in] DWORD dwDesiredAccess,
[in] DWORD dwFlagsAndAttributes
);
參數
[in] uPortNumber
要開啟之通訊裝置的一個型埠號碼。
[in] dwDesiredAccess
要求的裝置存取權。
如需要求存取的詳細資訊，請參閱 CreateFile 和 Create and Open Files。
[in] dwFlagsAndAttributes
裝置所要求的旗標和屬性。
注意
針對此函式，此參數只會預期 FILE_FLAG_OVERLAPPED或0x0 的值。
| 值 | 意義 |
|---|---|
|
正在開啟或建立異步 I/O 的檔案或裝置。 |
傳回值
如果函式成功，函式會傳回有效的 HANDLE。 使用 CloseHandle 關閉該句柄。
如果發生錯誤，函式會傳回 INVALID_HANDLE_VALUE。
備註
uPortNumber 參數接受以單一為基礎的值。 uPortNumber 的值為 1 會導致此函式嘗試開啟 COM1。
若要支援 UWP，請針對 WindowsApp.lib 連結。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 1709 版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 版本 1709 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | winbase.h (包含 Windows.h) |
| 程式庫 | OneCore.lib |
| Dll | KernelBase.dll |