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