функция lineBlindTransferA (tapi.h)

Функция lineBlindTransfer выполняет слепую или одношаговую передачу указанного вызова указанному целевому адресу.

Синтаксис

LONG lineBlindTransferA(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Параметры

hCall

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

lpszDestAddress

ТБD

dwCountryCode

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

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

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

LINEERR_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Замечания

Если возвращается LINEERR_INVALADDRESS, вызов не происходит.

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

Дескриптор вызова приложения остается действительным после завершения передачи. Приложение должно освободить свой дескриптор с помощью lineDeallocateCall, если он больше не заинтересован в переданном вызове.

Заметка

Заголовок tapi.h определяет lineBlindTransfer как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
целевая платформа	Виндоус
заголовка	tapi.h
библиотеки	Tapi32.lib
DLL	Tapi32.dll

См. также

LINE_REPLY

дополнительных функций службы

Обзор TAPI 2.2

Обзор передачи

lineDeallocateCall