функция TSPI_lineDrop (tspi.h)

Статья
08/26/2023

Функция TSPI_lineDrop удаляет или отключает указанный вызов. При необходимости данные пользователя могут передаваться при отключении звонка. Эта функция может быть вызвана приложением в любое время. Когда возвращается TSPI_lineDrop , вызов должен быть бездействующий.

Синтаксис

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Параметры

dwRequestID

Идентификатор асинхронного запроса.

hdCall

Дескриптор поставщика услуг для отбрасываемого вызова. Состояние вызова hdCall может быть любым, кроме состояния простоя.

lpsUserUserInfo

Этот указатель действителен, только если dwSize не имеет нуля. Он указывает указатель на строку, завершающуюся значением NULL, содержащую сведения о пользователе и пользователе, которые будут отправлены удаленной стороне в рамках отключения вызова. Этот указатель имеет значение NULL , если не требуется отправлять данные пользователя и пользователя. Сведения о пользователе отправляются, только если они поддерживаются базовой сетью (см. lineDEVCAPS).

dwSize

Размер в байтах сведений о пользователе в lpsUserUserInfo. Если параметр lpsUserUserInfo имеет значение NULL, dwSize игнорируется.

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

Возвращает dwRequestID или номер ошибки при возникновении ошибки. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG LINEERR_OPERATIONUNAVAIL.

При вызове TSPI_lineDrop также могут быть затронуты связанные вызовы. Например, удаление конференц-связи может привести к удалению всех отдельных участвующих звонков. LINE_CALLSTATE сообщения отправляются в TAPI для всех вызовов, состояние которых затрагивается. Как правило, удаленный вызов переходит в состояние простоя . Вызов TSPI_lineDrop при вызове в состоянии предложения отклоняет вызов. Не все телефонные сети предоставляют такую возможность.

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

В TAPI есть возможность отправлять данные пользователя и пользователя во время удаления. Даже если можно отправить сведения о пользователе, нет никакой гарантии, что сеть доставляет эти сведения удаленной стороне.

Примечание В различных конфигурациях линии моста или партий, когда в вызове находятся несколько сторон, TSPI_lineDrop могут не очистить вызов.