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 の値のみが必要です。

値	意味
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