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


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

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

Синтаксис

LONG ComDBOpen(
  [out] PHCOMDB PHComDB
);

Параметры

[out] PHComDB

Указатель на дескриптор базы данных COM-порта, если подпрограмма завершается успешно. В противном случае подпрограмма устанавливает для параметра *PHComDBзначение HCOMDB_INVALID_HANDLE_VALUE. PhComDB не должен иметь значение NULL.

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

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

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

Комментарии

Чтобы закрыть базу данных COM-порта, вызовите ComDBClose и укажите дескриптор, возвращенный ComDBOpen.

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

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

Требования

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

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

ComDBClose