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

Статья
03/05/2024

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

Синтаксис

LONG lineRedirect(
  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. Доступность этих операций зависит от возможностей устройства.