Metodo ITBasicCallControl::Conference (tapi3if.h)

Articolo
08/26/2023

Il metodo Conference aggiunge una chiamata di consultazione alla conferenza in cui la chiamata corrente è un partecipante. Se non esiste un oggetto ITCallHub associato, viene creato.

Sintassi

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

Parametri

[in] pCall

Puntatore all'interfaccia ITBasicCallControl per la chiamata di consultazione.

[in] fSync

Indica se la chiamata deve essere conferenza in modo sincrono (VARIANT_TRUE) o asincrona (VARIANT_FALSE). Per altre spiegazioni, vedere Connettersi .

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_POINTER	Il parametro pCall non è un puntatore valido.
E_INVALIDARG	Il parametro pCall non punta a un'interfaccia valida.
TAPI_E_TIMEOUT	L'operazione non è riuscita perché la DLL TAPI 3 ha superato il timeout. L'intervallo di timeout è di due minuti.

Commenti

Alcuni provider di servizi non supportano questa operazione mentre lo streaming è attivo. L'applicazione potrebbe dover chiamare ITStream::StopStream o ITSubStream::StopSubStream prima dell'operazione e ITStream::StartStream o ITSubStream::StartSubStream dopo il completamento dell'operazione.

La chiamata di consultazione (pCall) viene creata da ITAddress::CreateCall. La connessione viene completata chiamando il metodo Finish . Per un esempio di utilizzo di questo metodo, vedere Creare una conferenza semplice .

Se la chiamata di consultazione non è nello stato CONNECTED quando viene chiamata conferenza, TAPI userà l'indirizzo di destinazione (come specificato quando la chiamata di consultazione è stata creata per la prima volta tramite ITAddress::CreateCall) e proverà a connettersi in quel momento. Se la chiamata originale ha un indirizzo di destinazione NULL , Conference avrà esito negativo con E_INVALIDARG.