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

Article
03/02/2024

La méthode HandoffDirect transfère l’appel à une autre application. Cela indique que l’application n’a plus besoin de la propriété de l’appel.

Syntaxe

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

Paramètres

[in] pApplicationName

Pointeur vers BSTR contenant le nom d’application spécifique vers lequel passer l’appel. Il peut s’agir d’un nom de chemin d’accès complet ou d’un nom exécutable.

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 pApplicationName n’est pas un pointeur valide.

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.

Si l’application réceptrice n’a pas ouvert la ligne pour les types de médias impliqués dans l’appel, le transfert échoue. Si TAPI ne parvient pas à passer l’appel, TAPI appelle Disconnect.

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