ITBasicCallControl::Conference, méthode (tapi3if.h)

Article
08/26/2023

La méthode De conférence ajoute un appel de consultation à la conférence dans laquelle l’appel actuel est un participant. S’il n’existe pas d’objet ITCallHub associé, il est créé.

Syntaxe

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

Paramètres

[in] pCall

Pointeur vers l’interface ITBasicCallControl pour l’appel de consultation.

[in] fSync

Indique si l’appel doit être conférencené de manière synchrone (VARIANT_TRUE) ou asynchrone (VARIANT_FALSE). Pour plus d’explication, consultez Se connecter .

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La méthode a réussi.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_POINTER	Le paramètre pCall n’est pas un pointeur valide.
E_INVALIDARG	Le paramètre pCall ne pointe pas vers une interface valide.
TAPI_E_TIMEOUT	L’opération a échoué car la DLL TAPI 3 a expiré. L’intervalle de délai d’expiration est de deux minutes.

Remarques

Certains fournisseurs de services ne prennent pas en charge cette opération pendant que la diffusion en continu est active. L’application peut avoir besoin d’appeler ITStream::StopStream ou ITSubStream::StopSubStream avant l’opération et ITStream::StartStream ou ITSubStream::StartSubStream une fois l’opération terminée.

L’appel de consultation (pCall) est créé par ITAddress::CreateCall. La connexion est terminée en appelant la méthode Finish . Pour obtenir un exemple d’utilisation de cette méthode, consultez Créer une conférence simple .

Si l’appel de consultation n’est pas dans l’état CONNECTED lors de l’appel de La conférence, TAPI utilise l’adresse de destination (comme spécifié lors de la création de l’appel de consultation via ITAddress::CreateCall) et tente de se connecter à ce moment-là. Si l’appel d’origine avait une adresse de destination NULL , la conférence échoue avec E_INVALIDARG.