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

Artigo
08/26/2023

O método Conference adiciona uma chamada de consulta à conferência na qual a chamada atual é um participante. Se um objeto ITCallHub associado não existir, ele será criado.

Sintaxe

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

Parâmetros

[in] pCall

Ponteiro para a interface ITBasicCallControl para a chamada de consulta.

[in] fSync

Indica se a chamada deve ser conferência de forma síncrona (VARIANT_TRUE) ou de forma assíncrona (VARIANT_FALSE). Consulte Conectar para obter explicações adicionais.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Há memória insuficiente para executar a operação.
E_POINTER	O parâmetro pCall não é um ponteiro válido.
E_INVALIDARG	O parâmetro pCall não aponta para uma interface válida.
TAPI_E_TIMEOUT	A operação falhou porque a DLL do TAPI 3 atingiu o tempo limite. O intervalo de tempo limite é de dois minutos.

Comentários

Alguns provedores de serviços não dão suporte a essa operação enquanto o streaming está ativo. O aplicativo pode precisar chamar ITStream::StopStream ou ITSubStream::StopSubStream antes da operação e ITStream::StartStream ou ITSubStream::StartSubStream após a conclusão da operação.

A chamada de consulta (pCall) é criada por ITAddress::CreateCall. A conexão é concluída chamando o método Finish . Consulte Criar uma Conferência Simples para obter um exemplo de como usar esse método.

Se a chamada de consulta não estiver no estado CONNECTED quando a Conferência for chamada, o TAPI usará o endereço de destino (conforme especificado quando a chamada de consulta foi criada pela primeira vez por meio de ITAddress::CreateCall) e tentará se conectar nesse momento. Se a chamada original tiver um endereço de destino NULL , a Conferência falhará com E_INVALIDARG.