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

Статья
08/26/2023

Функция lineRemoveFromConference удаляет указанный вызов из конференции, к которой он принадлежит в данный момент. Остальные звонки в конференции не затрагиваются.

Синтаксис

LONG lineRemoveFromConference(
  HCALL hCall
);

Параметры

hCall

Дескриптор вызова, который будет удален из конференции. Приложение должно быть владельцем этого вызова. Состояние вызова hCall должно быть конференционировано.

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

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

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER LINEERR_UNINITIALIZED.

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

Если удаление участника из конференции поддерживается, звонок участника после удаления из конференции переходит в состояние вызова, указанное в элементе dwRemoveFromConfState в LINEADDRESSCAPS.