OpenCommPort 関数 (winbase.h)
通信デバイスを開こうとします。
構文
HANDLE OpenCommPort(
[in] ULONG uPortNumber,
[in] DWORD dwDesiredAccess,
[in] DWORD dwFlagsAndAttributes
);
パラメーター
[in] uPortNumber
通信デバイスが開く 1 から始まるポート番号。
[in] dwDesiredAccess
デバイスへの要求されたアクセス。
要求されたアクセスの詳細については、「 CreateFile 」および「 ファイルの作成と開く」を参照してください。
[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 |