Partager via


fonction lineSwapHold (tapi.h)

La fonction lineSwapHold permute l’appel actif spécifié avec l’appel spécifié en attente de consultation.

Syntaxe

LONG lineSwapHold(
  HCALL hActiveCall,
  HCALL hHeldCall
);

Paramètres

hActiveCall

Gérez l’appel actif. L’application doit être propriétaire de l’appel. L’état d’appel de hActiveCall doit être connecté.

hHeldCall

Gérez l’appel de consultation. L’application doit être propriétaire de l’appel. L’état d’appel de hHeldCall peut être onHoldPendingTransfer, onHoldPendingConference ou onHold.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone, ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message LINE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Remarques

L’échange de l’appel actif avec l’appel en attente de consultation permet à l’application d’alterner ou de basculer entre ces deux appels. Il s’agit généralement d’un appel en attente.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête tapi.h
Bibliothèque Tapi32.lib
DLL Tapi32.dll

Voir aussi

LINE_REPLY

Fonctions de service de ligne supplémentaires

Vue d’ensemble de la référence TAPI 2.2