Метод ITBasicCallControl::Transfer (tapi3if.h)

Статья
03/05/2024

Метод Transfer передает текущий вызов на адрес назначения.

Синтаксис

HRESULT Transfer(
  [in] ITBasicCallControl *pCall,
  [in] VARIANT_BOOL       fSync
);

Параметры

[in] pCall

Указатель на интерфейс ITBasicCallControl вызова консультации, созданного для передачи.

[in] fSync

Указывает, должен ли метод выполняться синхронно (VARIANT_TRUE) или асинхронно (VARIANT_FALSE).

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

Этот метод может возвращать одно из этих значений.

Значение	Значение
S_OK	Метод успешно выполнен.
E_INVALIDARG	Параметр pCall не указывает на допустимый вызов.
E_FAIL	Передача не поддерживается.
E_OUTOFMEMORY	Для выполнения операции недостаточно памяти.
TAPI_E_TIMEOUT	Операция завершилась сбоем, так как время ожидания библиотеки DLL TAPI 3 истекло. Интервал времени ожидания составляет две минуты.

Некоторые поставщики услуг не поддерживают эту операцию во время активной потоковой передачи. Приложению может потребоваться вызвать ITStream::StopStream или ITSubStream::StopSubStream перед операцией и ITStream::StartStream или ITSubStream::StartSubStream после завершения операции.

Передача звонков включает в себя создание консультационного звонка в рамках подготовки к передаче. pCall — это указатель ITBasicCallControl , возвращенный ITAddress::CreateCall после создания вызова консультации. ITBasicCallControl::Finish (FM_ASTRANSFER) завершает передачу.

Если звонок консультации не находится в состоянии CONNECTED при вызове метода Transfer , TAPI будет использовать адрес назначения (как указано при первом создании вызова консультации через ITAddress::CreateCall) и попытаться подключиться в это время. Если исходный вызов имел адрес назначения NULL , передача завершится сбоем с E_INVALIDARG.