ITAddress::Forward, méthode (tapi3if.h)

Article
08/26/2023

La méthode Forward transfère les appels destinés à l’adresse conformément aux instructions de transfert contenues dans ITForwardInformation. Si pForwardInfo a la valeur NULL, le transfert est annulé.

Syntaxe

HRESULT Forward(
  [in] ITForwardInformation *pForwardInfo,
  [in] ITBasicCallControl   *pCall
);

Paramètres

[in] pForwardInfo

Pointeur vers l’interface ITForwardInformation ou défini sur NULL pour annuler le transfert.

[in] pCall

Pointeur vers l’interface ITBasicCallControl pour l’appel de consultation, si nécessaire par l’environnement de téléphonie. Peut être NULL si ce n’est pas nécessaire.

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_INVALIDARG	L’adresse ne prend pas en charge le transfert ou pCall ne pointe pas vers un appel valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération.
E_POINTER	Le paramètre pForwardInfo ou pCall n’est pas un pointeur valide.
TAPI_E_TIMEOUT	L’opération a échoué, car la DLL TAPI 3 l’a expiré. L’intervalle de délai d’expiration est de deux minutes.
LINEERR_	Consultez LineForward pour obtenir les codes d’erreur retournés par cette fonction TAPI 2.1.

Remarques

Les informations contenues dans pForwardInfo remplacent toutes les instructions de transfert précédentes.

Si ITAddress::p ut_DoNotDisturb est appelé avec fDoNotDisturb défini sur VARIANT_FALSE, tout le transfert est annulé.

Une application peut déterminer si un appel de consultation non NULL est requis en appelant ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS, plCapability) et en vérifiant si l’indicateur LINEADDRCAPFLAGS_FWDCONSULT, membre de LINEADDRCAPFLAGS_ Constantes, a été défini dans plCapability. S’il est défini, une valeur non NULL est requise pour le paramètre pCall de la méthode Forward.

La méthode Forward est, en partie, un wrapper COM pour la fonction LineForward TAPI 2.1.