fonction lineSwapHold (tapi.h)

Article
03/02/2024

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.