ComDBResizeDatabase 関数 (msports.h)

ComDBResizeDatabase は、COM ポートデータベースのサイズを変更します。

構文

LONG ComDBResizeDatabase(
  [in] HCOMDB HComDB,
  [in] DWORD  NewSize
);

[in] HComDB

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

[in] NewSize

COM ポートデータベースの新しいサイズを指定します。データベースサイズは、データベース内で現在裁定されているポート番号の数です。この値は、1024 の整数倍数である必要があり、現在のサイズより大きくする必要があり、COMDB_MAX_PORTS_ARBITRATED以下である必要があります。

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

リターンコード	説明
ERROR_SUCCESS	データベースのサイズが正常に変更されました。
ERROR_BAD_LENGTH	NewSize が現在のデータベースサイズ以下であるか、COMDB_MAX_PORTS_ARBITRATEDを超えています。
ERROR_CANTWRITE	ルーチンがデータベースに書き込めませんでした。
ERROR_INVALID_PARAMETER	次のいずれかが当てはまります:COM ポートデータベースに対する指定されたハンドルが無効です。 NewSize は 1024 の倍数ではありません。
ERROR_NOT_CONNECTED	ルーチンがデータベースにアクセスできませんでした。詳細なエラー情報を得るには、GetLastError を呼び出します。

ComDBGetCurrentPortUsage を使用して、現在のデータベースサイズを取得します。

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

詳細については、「 COM ポートデータベースのサイズ変更」を参照してください。