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	以下任一项为 true：COM 端口数据库的指定句柄无效。 NewSize 不是 1024 的倍数。
ERROR_NOT_CONNECTED	例程无法访问数据库。要获得更多的错误信息，请调用 GetLastError。

使用 ComDBGetCurrentPortUsage 获取当前数据库大小。

ComDBResizeDatabase 在用户模式下运行。