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

Article
03/02/2024

La méthode Transfer transfère l’appel actuel à l’adresse de destination.

Syntaxe

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

Paramètres

[in] pCall

Pointeur vers l’interface ITBasicCallControl de l’appel de consultation créé pour le transfert.

[in] fSync

Indique si la méthode doit être effectuée de manière synchrone (VARIANT_TRUE) ou asynchrone (VARIANT_FALSE).

Valeur retournée

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

Valeur	Signification
S_OK	La méthode a réussi.
E_INVALIDARG	Le paramètre pCall ne pointe pas vers un appel valide.
E_FAIL	Transferts non pris en charge.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
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.

Le transfert d’appel implique la mise en place d’un appel de consultation en vue du transfert. pCall est le pointeur ITBasicCallControl retourné par ITAddress ::CreateCall après la création d’un appel de consultation. ITBasicCallControl ::Finish (FM_ASTRANSFER) termine le transfert.

Si l’appel de consultation n’est pas dans l’état CONNECTED lors de l’appel de Transfert , 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 , le transfert échoue avec E_INVALIDARG.