GetCommPorts 関数 (winbase.h)
整形式の COM ポートを含む配列を取得します。
この関数は、 HKLM\Hardware\DeviceMap\SERIALCOMM レジストリ キーから COM ポート番号を取得し、呼び出し元が指定した配列に書き込みます。 配列が小さすぎる場合、関数は必要なサイズを取得します。
メモ レジストリ キーに新しいエントリが追加されると、API 呼び出しの間で必要なサイズが変更される可能性があります。
構文
ULONG GetCommPorts(
[out] PULONG lpPortNumbers,
[in] ULONG uPortNumbersCount,
[out] PULONG puPortNumbersFound
);
パラメーター
[out] lpPortNumbers
ポート番号の配列。
[in] uPortNumbersCount
lpPortNumbers パラメーター内の配列の長さ。
[out] puPortNumbersFound
lpPortNumbers に書き込まれたポート番号の数、またはポート番号に必要な配列の長さ。
戻り値
リターン コード | 説明 |
---|---|
|
呼び出しは成功しました。 lpPortNumbers 配列は、結果に十分な大きさでした。 |
|
lpPortNumbers 配列が小さすぎて、使用可能なすべてのポート番号が含まれなかった。 |
|
使用可能な通信ポートはありません。 |
要件
サポートされている最小のクライアント | Windows 10 バージョン 1803 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server バージョン 1709 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | winbase.h (Windows.h を含む) |
Library | OneCore.lib |
[DLL] | KernelBase.dll |