Функция lineBlindTransfer (tapi.h)

Статья
08/26/2023

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

Синтаксис

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

Параметры

hCall

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

lpszDestAddress

TBD

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.

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

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