Функция lineClose (tapi.h)

Статья
08/26/2023

Функция lineClose закрывает указанное устройство открытой линии.

Синтаксис

LONG lineClose(
  HLINE hLine
);

Параметры

hLine

Дескриптор на закрываемом устройстве с открытой линией. После успешного закрытия строки этот дескриптор становится недействительным.

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

Возвращает ноль при успешном выполнении запроса или отрицательное число ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED LINEERR_OPERATIONUNAVAIL.

Если приложение вызывает lineClose , пока оно по-прежнему имеет активные вызовы в открытой строке, владение этими вызовами у приложения отменяется. Если приложение было единственным владельцем этих вызовов, вызовы также удаляются. Рекомендуется программировать для приложения удаление принадлежащих ему вызовов в открытой строке путем явного отказа от владения и /или путем удаления этих вызовов до закрытия строки.

Если строка была успешно закрыта, LINE_LINEDEVSTATE сообщение отправляется всем приложениям, которые отслеживают состояние строки при открытии или закрытии. Невыполненные асинхронные ответы подавляются.

Поставщики услуг могут оказаться полезными или необходимыми принудительно освободить линейные устройства из приложения с открытой линией. Это может быть полезно, чтобы приложение не монопольно настроилось на линейное устройство в течение слишком долгого времени. В этом случае в приложение отправляется сообщение LINE_CLOSE, указывающее дескриптор линии закрытого устройства.

Функция lineOpen выделяет ресурсы для вызывающего приложения, и приложениям может быть запрещено открывать строку, если ресурсы недоступны. Поэтому приложение, которое только иногда использует устройство линии (например, для исходящих вызовов), должно закрыть линию для освобождения ресурсов и разрешить другим приложениям открывать линию.