fonction lineAddToConference (tapi.h)

Article
03/04/2024

La fonction lineAddToConference ajoute l’appel spécifié par hConsultCall à la téléconférence spécifiée par hConfCall.

Syntaxe

LONG lineAddToConference(
  HCALL hConfCall,
  HCALL hConsultCall
);

Paramètres

hConfCall

Gérer jusqu’à la téléconférence. L’application doit être propriétaire de cet appel. Toute surveillance (médias, tonalités, chiffres) d’une téléconférence s’applique uniquement à hConfCall, et non aux appels individuels participants. L’état d’appel de hConfCall doit être onHoldPendingConference ou onHold.

hConsultCall

Handle à l’appel à ajouter à la téléconférence. L’application doit être propriétaire de cet appel. Cet appel ne peut pas être un parent d’une autre conférence ou un participant à une conférence. Selon les fonctionnalités de l’appareil indiquées dans LINEADDRESSCAPS, le hConsultCall n’a pas nécessairement été établi à l’aide de lineSetupConference ou linePrepareAddToConference. L’état de l’appel de hConsultCall doit être connecté, onHold, en cours ou ringback. De nombreux PBX permettent d’ajouter des appels à des conférences avant qu’ils ne reçoivent réellement de réponse.

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 il s’agit d’un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

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

Remarques

Si LINEERR_INVALCALLHANDLE est retourné, le handle d’appel spécifié pour l’appel ajouté n’est pas valide ; hConsultCall est un parent d’une autre conférence ou déjà un participant à une conférence ; hConsultCall ne peut pas être ajouté pour d’autres raisons (par exemple, il doit avoir été établi à l’aide de lineSetupConference ou linePrepareAddToConference) ; ou hConsultCall et hConfCall sont des appels sur différentes lignes ouvertes.

Le handle d’appel de la partie ajoutée reste valide après l’ajout de l’appel à une conférence. Son état passe généralement à conferenced tandis que l’état de la téléconférence devient généralement connecté. À l’aide de lineGetConfRelatedCalls, vous pouvez obtenir une liste de descripteurs d’appel qui font partie de la même téléconférence que l’appel spécifié. L’appel spécifié est une téléconférence ou un appel de participant dans une téléconférence. De nouveaux handles sont générés pour les appels pour lesquels l’application n’a pas encore de handles, et l’application se voit accorder le privilège de surveillance pour ces appels. Le handle d’un appel individuel participant peut être utilisé ultérieurement pour supprimer cette partie de la téléconférence à l’aide de lineRemoveFromConference.

Si lineGetConfRelatedCalls est appelé immédiatement après lineAddToConference, il peut ne pas renvoyer la liste complète des appels associés, car TAPI attend de recevoir un message LINE_CALLSTATE indiquant que l’appel est entré LINECALLSTATE_CONFERENCED avant de considérer l’appel comme faisant partie de la conférence (autrement dit, l’état de conférence est confirmé par le fournisseur de services). Une fois que l’application a reçu le message LINE_CALLSTATE, lineGetConfRelatedCalls retourne des informations complètes .

Note Tous les appels qui font partie d’une conférence doivent exister sur la même ligne ouverte.

Les états d’appel des appels participant à une conférence ne sont pas indépendants. Par exemple, lors de la suppression d’une téléconférence, tous les appels participants peuvent automatiquement devenir inactifs. Une application doit consulter les fonctionnalités de l’appareil de la ligne pour déterminer la forme de suppression de conférence disponible. L’application doit suivre les messages LINE_CALLSTATE pour déterminer ce qui est arrivé aux appels impliqués.

La téléconférence est établie par lineSetupConference ou lineCompleteTransfer. L’appel ajouté à une conférence est généralement établi à l’aide de lineSetupConference ou linePrepareAddToConference. Certains commutateurs peuvent autoriser l’ajout d’appels arbitraires à la conférence, et un tel appel peut avoir été configuré à l’aide de lineMakeCall et être en attente (dure). L’application peut examiner le membre dwAddrCapFlags de la structure LINEADDRESSCAPS pour déterminer les opérations autorisées.