ComDBReleasePort 関数 (msports.h)

ComDBReleasePort は 、COM ポートデータベース内の COM ポート番号を解放します。

構文

LONG ComDBReleasePort(
  [in] HCOMDB HComDB,
  [in] DWORD  ComNumber
);

[in] HComDB

ComDBOpen によって返された COM ポートデータベースへのハンドル。

[in] ComNumber

解放する COM ポート番号を指定します。ポート番号は、1 からCOMDB_MAX_PORTS_ARBITRATEDまでの範囲の整数です。

ComDBReleasePort は 、次のいずれかの状態値を返します。

リターンコード	説明
ERROR_SUCCESS	COM ポート番号がリリースされました。
ERROR_CANTWRITE	ルーチンがデータベースに書き込めませんでした。
ERROR_INVALID_PARAMETER	次のいずれかが true です。COM ポートデータベースに対する指定されたハンドルが無効です。指定したポート番号が COM ポートデータベースにありません。
ERROR_NOT_CONNECTED	ルーチンがデータベースにアクセスできませんでした。詳細なエラー情報を得るには、GetLastError を呼び出します。

COM ポート番号を解放すると、ポート番号が "使用されていません" としてログに記録されます。

ComDBReleasePort は ユーザーモードで実行されます。

詳細については、「 COM ポート番号の取得と解放」を参照してください。