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

Article
03/04/2024

La méthode BlindTransfer effectue un transfert aveugle ou en une seule étape de l’appel spécifié vers l’adresse de destination spécifiée. L’application doit être propriétaire de l’appel. Après un transfert réussi, l’état de l’appel passe à CS_DISCONNECTED.

Syntaxe

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

Paramètres

[in] pDestAddress

Pointeur vers BSTR contenant l’adresse de destination pour le transfert.

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_POINTER	PDestAddress n’est pas un pointeur valide.
E_FAIL	Le transfert aveugle n’est pas 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.

L’application doit utiliser SysAllocString pour allouer de la mémoire au paramètre pDestAddress et utiliser SysFreeString pour libérer la mémoire lorsque la variable n’est plus nécessaire.

Dans certains cas, l’application peut avoir besoin d’utiliser les interfaces de traduction d’adresses ( ITAddressTranslation et ITAddressTranslationInfo) pour obtenir une chaîne pDestAddress au format approprié.