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

Статья
08/26/2023

Метод Conference добавляет консультационный вызов к конференции, участником которой является текущий звонок. Если связанный объект ITCallHub не существует, он создается.

Синтаксис

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

Параметры

[in] pCall

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

[in] fSync

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

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

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

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

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

Вызов консультации (pCall) создается ITAddress::CreateCall. Соединение завершается путем вызова метода Finish . Пример использования этого метода см. в разделе Создание простой конференции .

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