TSPI_lineAddToConference, fonction (tspi.h)

Article
08/26/2023

La fonction TSPI_lineAddToConference ajoute l’appel spécifié par hdConsultCall à la téléconférence spécifiée par hdConfCall.

Syntaxe

LONG TSPIAPI TSPI_lineAddToConference(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdConfCall,
  HDRVCALL      hdConsultCall
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdConfCall

Handle de la téléconférence. L’état d’appel de hdConfCall peut être onHoldPendingConference ou onHold.

hdConsultCall

Handle à l’appel à ajouter à la téléconférence. 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 paramètre hdConsultCall n’a pas nécessairement été établi à l’aide de TSPI_lineSetupConference ou de TSPI_linePrepareAddToConference. L’état de l’appel de hdConsultCall peut être connecté, onHold, en cours ou ringback.

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult du ASYNC_COMPLETION correspondant est égal à zéro si la fonction réussit ou un numéro d’erreur si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_CONFERENCEFULL, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.

Remarques

Le fournisseur de services retourne LINEERR_INVALCALLHANDLE si hdConsultCall est un parent d’une autre conférence ou déjà un participant à une conférence, ou si hdConsultCall ne peut pas être ajouté pour d’autres raisons, telles qu’il doit avoir été établi à l’aide de TSPI_lineSetupConference ou de TSPI_linePrepareAddToConference.

Note Le handle d’appel de la partie ajoutée reste valide après l’ajout de l’appel à une conférence ; en règle générale, son état passe à conferenced pendant que l’état de la téléconférence devient connecté. 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 TSPI_lineRemoveFromConference.

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. TAPI peut consulter les fonctionnalités de l’appareil de la ligne pour déterminer la forme de suppression de conférence disponible. TAPI ou ses applications clientes doivent suivre les messages LINE_CALLSTATE pour déterminer ce qui est arrivé aux appels impliqués.

La téléconférence est établie par TSPI_lineSetupConference ou TSPI_lineCompleteTransfer. En règle générale, l’appel ajouté à une conférence est établi à l’aide de TSPI_lineSetupConference ou de TSPI_linePrepareAddToConference. Certains commutateurs peuvent autoriser l’ajout d’un appel arbitraire à une conférence, et un tel appel peut avoir été configuré à l’aide de TSPI_lineMakeCall et être en attente (dure). Tous les appels qui font partie d’une conférence doivent exister sur la même ligne ouverte.

Toute surveillance (médias, tonalités, chiffres) d’une téléconférence s’applique uniquement au paramètre hdConfCall , et non aux appels individuels participants.

Cette fonction n’a aucune restriction basée sur les privilèges, comme dans la fonction correspondante au niveau TAPI. Il n’est pas explicitement nécessaire que le fournisseur de services effectue le suivi des relations entre la téléconférence « parente » et ses participants, car il n’existe aucune correspondance TSPI avec la fonction TAPI. De nombreux fournisseurs de services peuvent trouver nécessaire de suivre ces relations en interne pour implémenter les autres fonctions de gestion des téléconférences.