Поделиться через

Функция ComDBResizeDatabase (msports.h)

  • Статья

ComDBResizeDatabase изменяет размер базы данных COM-портов.

Синтаксис

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

Параметры

[in] HComDB

Обработка базы данных COM-порта, возвращенной ComDBOpen.

[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 выполняется в пользовательском режиме.

Дополнительные сведения см. в статье Изменение размера базы данных com-портов.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть msports.h (включая Msports.h)
Библиотека Msports.lib
DLL Msports.dll

См. также раздел

ComDBGetCurrentPortUsage