ComDBClaimNextFreePort 関数 (msports.h)
ComDBClaimNextFreePort は、まだ使用されていない最小の COM ポート番号を返します。
構文
LONG ComDBClaimNextFreePort(
[in] HCOMDB HComDB,
[out] LPDWORD ComNumber
);
パラメーター
[in] HComDB
ComDBOpen によって返される COM ポート データベースへのハンドル。
[out] ComNumber
ルーチンが呼び出し元に返す COM ポート番号へのポインター。 このポインターは NULL 以外である必要があります。 ポート番号は、1 ~ COMDB_MAX_PORTS_ARBITRATEDの範囲の整数です。
戻り値
ComDBClaimNextFreePort は 、次のいずれかの状態値を返します。
| リターン コード | 説明 |
|---|---|
|
ルーチンから COM ポート番号が正常に返されました。 |
|
ルーチンがデータベースに書き込めませんでした。 |
|
指定された COM ポート データベース ハンドルが無効です。 |
|
データベースはこれ以上ポート番号を確認できません。 |
|
ルーチンがデータベースにアクセスできませんでした。 詳細なエラー情報を得るには、GetLastError を呼び出します。 |
|
内部エラーが発生しました。 GetLastError を呼び出して、拡張エラー情報を取得します。 |
注釈
COM ポート データベースで COM ポート番号を要求すると、ポート番号が "使用中" としてログに記録されます。 データベースには、ポート番号を要求する呼び出し元またはデバイスに関する情報は含まれていないことに注意してください。
ComDBClaimNextFreePort は ユーザー モードで実行されます。
詳細については、「 COM ポート番号の取得と解放」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | msports.h (Msports.h を含む) |
| Library | Msports.lib |
| [DLL] | Msports.dll |