функция TSPI_lineRedirect (tspi.h)
Функция TSPI_lineRedirect перенаправляет указанный вызов предложения на указанный адрес назначения.
Синтаксис
LONG TSPIAPI TSPI_lineRedirect(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Параметры
dwRequestID
Идентификатор асинхронного запроса.
hdCall
Дескриптор перенаправляемого вызова. Состояние вызова hdCall может быть предложением.
lpszDestAddress
Указатель на строку Юникода, завершающуюся значением NULL, которая указывает адрес назначения. Это соответствует стандартному формату ссылок.
dwCountryCode
Код страны или региона стороны, в который перенаправляется вызов. Если указано значение 0, реализация использует значение по умолчанию. Этот параметр не проверяется TAPI при вызове этой функции.
Возвращаемое значение
Возвращает dwRequestID или номер ошибки, если произошла ошибка. Фактический параметр lResult соответствующего ASYNC_COMPLETION равен нулю при успешном выполнении функции или номеру ошибки при возникновении ошибки. Возможные возвращаемые значения:
LINEERR_INVALCALLHANDLE, LINEERR_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS LINEERR_RESOURCEUNAVAIL.
Комментарии
Поставщик услуг не перенаправляет вызов, если он возвращает LINEERR_INVALADDRESS.
При вызове этой функции поставщик услуг отклоняет вызов предложения на другой адрес, не отвечая на вызов. Перенаправление звонков отличается от переадресации звонков тем, что переадресация звонков выполняется коммутатором без участия вызываемой станции; перенаправление может выполняться клиентским приложением по вызову, например с учетом сведений об идентификаторе вызывающего абонента. Он отличается от передачи звонков тем, что для передачи звонка необходимо сначала ответить на звонок.
После успешного перенаправления вызова вызов обычно переходит в режим простоя. Поставщик услуг указывает новое состояние с помощью сообщения LINE_CALLSTATE .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | tspi.h |