Método ITBasicCallControl::Conference (tapi3if.h)

Artículo
03/08/2023

El método Conference agrega una llamada de consulta a la conferencia en la que la llamada actual es participante. Si no existe un objeto ITCallHub asociado, se crea.

Sintaxis

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

Parámetros

[in] pCall

Puntero a la interfaz ITBasicCallControl para la llamada de consulta.

[in] fSync

Indica si la llamada debe estar en conferencia de forma sincrónica (VARIANT_TRUE) o de forma asincrónica (VARIANT_FALSE). Consulte Conexión para obtener una explicación adicional.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_POINTER	El parámetro pCall no es un puntero válido.
E_INVALIDARG	El parámetro pCall no apunta a una interfaz válida.
TAPI_E_TIMEOUT	Error en la operación porque el archivo DLL tapi 3 lo agotó. El intervalo de tiempo de espera es de dos minutos.

Comentarios

Algunos proveedores de servicios no admiten esta operación mientras el streaming está activo. Es posible que la aplicación tenga que llamar a ITStream::StopStream o ITSubStream::StopSubStream antes de la operación y ITStream::StartStream o ITSubStream::StartSubStream después de completar la operación.

ITAddress::CreateCall crea la llamada de consulta (pCall). La conexión se completa llamando al método Finish . Consulte Creación de una conferencia simple para obtener un ejemplo de uso de este método.

Si la llamada de consulta no está en el estado CONNECTED cuando se llama a Conference, TAPI usará la dirección de destino (como se especifica cuando la llamada de consulta se creó por primera vez a través de ITAddress::CreateCall) e intentará conectarse en ese momento. Si la llamada original tenía una dirección de destino NULL , la conferencia producirá un error con E_INVALIDARG.