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

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

  • Статья

ComDBClaimNextFreePort возвращает наименьший номер COM-порта, который еще не используется.

Синтаксис

LONG ComDBClaimNextFreePort(
  [in]  HCOMDB  HComDB,
  [out] LPDWORD ComNumber
);

Параметры

[in] HComDB

Дескриптор в базу данных COM-порта, возвращаемую ComDBOpen.

[out] ComNumber

Указатель на номер COM-порта, который подпрограмма возвращает вызывающей. Этот указатель должен иметь значение, отличное от NULL. Номер порта — это целое число в диапазоне от 1 до COMDB_MAX_PORTS_ARBITRATED.

Возвращаемое значение

ComDBClaimNextFreePort возвращает одно из следующих значений состояния.

Код возврата Описание
ERROR_SUCCESS
 Подпрограмма успешно вернула номер COM-порта.
ERROR_CANTWRITE
 Подпрограмме не удалось выполнить запись в базу данных.
ERROR_INVALID_PARAMETER
 Указанный дескриптор базы данных COM-порта недопустим.
ERROR_NO_LOG_SPACE
 База данных не может выполнять арбитраж номеров портов.
ERROR_NOT_CONNECTED
 Подпрограмме не удалось получить доступ к базе данных. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
ERROR_Xxx
 Произошла внутренняя ошибка; вызовите GetLastError , чтобы получить расширенные сведения об ошибке.

Комментарии

При утверждении номера COM-порта в базе данных COM-порта номер порта регистрируется как "используемый". Обратите внимание, что база данных не содержит сведений о вызывающем объекте или устройстве, на котором указан номер порта.

ComDBClaimNextFreePort выполняется в пользовательском режиме.

Дополнительные сведения см. в разделе Получение и освобождение номера COM-порта.

Требования

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

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

ComDBClaimPort

ComDBReleasePort