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

Метод 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.

Требования

Требование Значение
Целевая платформа Windows
Header tapi3if.h (включая Tapi3.h)
Библиотека Uuid.lib
DLL Tapi3.dll

См. также раздел

Объект call

Конференции

Готово

ITAddress::CreateCall

ITBasicCallControl

Общие сведения о переносе