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 は、次のいずれかの状態値を返します。
| リターン コード | 説明 |
|---|---|
|
データベースのサイズが正常に変更されました。 |
|
NewSize が現在のデータベース サイズ以下であるか、COMDB_MAX_PORTS_ARBITRATEDを超えています。 |
|
ルーチンがデータベースに書き込めませんでした。 |
|
次のいずれかが当てはまります:COM ポート データベースに対する指定されたハンドルが無効です。 NewSize は 1024 の倍数ではありません。 |
|
ルーチンがデータベースにアクセスできませんでした。 詳細なエラー情報を得るには、GetLastError を呼び出します。 |
解説
ComDBGetCurrentPortUsage を使用して、現在のデータベース サイズを取得します。
ComDBResizeDatabase は ユーザー モードで実行されます。
詳細については、「 COM ポート データベースのサイズ変更」を参照してください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | msports.h (Msports.h を含む) |
| Library | Msports.lib |
| [DLL] | Msports.dll |