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

Функция lineRedirect перенаправляет указанный вызов предложения на указанный целевой адрес.

Синтаксис

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

Параметры

hCall

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

lpszDestAddress

Указатель на целевой адрес. Это соответствует стандартному формату номерного номера.

dwCountryCode

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

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

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

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

Замечания

Перенаправление звонков позволяет приложению отклонять предлагаемый звонок на другой адрес без первого ответа на звонок. Перенаправление вызовов отличается от переадресации звонков в этом переадресации звонков выполняется коммутатором без участия приложения; перенаправление можно выполнить на основе вызова приложением, например, на основе сведений об идентификаторе вызывающего объекта. Он отличается от передачи звонков в том, что передача звонка требует, чтобы сначала был ответ на звонок.

После успешного перенаправления вызова вызов обычно переходит в состояние простоя.

Помимо перенаправления входящего вызова, приложение может иметь возможность принять вызов с помощью lineAccept, отклонить вызов с помощью lineDropили ответить на вызов с помощью lineAnswer. Доступность этих операций зависит от возможностей устройств.

Заметка

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

Требования

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

См. также

LINE_REPLY

Обзор перенаправления

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

Обзор TAPI 2.2

lineAccept

lineAnswer

lineDrop