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

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

  • Статья

ComDBReleasePort освобождает номер COM-порта в базе данных COM-портов.

Синтаксис

LONG ComDBReleasePort(
  [in] HCOMDB HComDB,
  [in] DWORD  ComNumber
);

Параметры

[in] HComDB

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

[in] ComNumber

Указывает номер COM-порта, который необходимо освободить. Номер порта — это целое число, которое находится в диапазоне от единицы до COMDB_MAX_PORTS_ARBITRATED.

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

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

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

Комментарии

Освобождение номера COM-порта означает регистрировать номер порта как "не используется".

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

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

Требования

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

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

ComDBClaimNextFreePort

ComDBClaimPort