функция TSPI_lineDrop (tspi.h)
Функция 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.
Комментарии
Поставщик услуг возвращает LINEERR_INVALCALLSTATE, если текущее состояние вызова не позволяет удалить вызов.
При вызове TSPI_lineDrop также могут быть затронуты связанные вызовы. Например, удаление конференц-связи может привести к удалению всех отдельных участвующих звонков. LINE_CALLSTATE сообщения отправляются в TAPI для всех вызовов, состояние которых затрагивается. Как правило, удаленный вызов переходит в состояние простоя . Вызов TSPI_lineDrop при вызове в состоянии предложения отклоняет вызов. Не все телефонные сети предоставляют такую возможность.
В ситуациях, когда звонок, который должен быть удален, является вызовом консультации, установленным во время передачи или создания конференц-звонка, исходный звонок, который был помещен в состояние OnHoldPending , повторно подключается к и, как правило, повторно переходит в состояние подключенного звонка.
В TAPI есть возможность отправлять данные пользователя и пользователя во время удаления. Даже если можно отправить сведения о пользователе, нет никакой гарантии, что сеть доставляет эти сведения удаленной стороне.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | tspi.h |