fonction lineGetConfRelatedCalls (tapi.h)

Article
03/04/2024

La fonction lineGetConfRelatedCalls retourne une liste de handles 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 à 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 un privilège de supervision pour ces appels.

Syntaxe

LONG lineGetConfRelatedCalls(
  HCALL          hCall,
  LPLINECALLLIST lpCallList
);

Paramètres

hCall

Gérer à un appel. Il s’agit d’une téléconférence ou d’un appel de participants dans une téléconférence. Pour un appel parent de conférence, l’état de l’appel de hCall peut être n’importe quel état. Pour une conférence téléphonique d’un participant, elle doit être à l’état conférence.

lpCallList

Pointeur vers une structure de données de taille variable de type LINECALLLIST. Une fois la demande terminée, les handles d’appel à tous les appels de la téléconférence sont retournés dans cette structure. Le premier appel de la liste est la téléconférence, les autres appels sont les appels des participants. L’application bénéficie d’un privilège de supervision pour les appels pour lesquels elle ne dispose pas déjà de handles ; les privilèges d’appels dans la liste pour lesquels l’application dispose déjà de handles sont inchangés. Avant d’appeler lineGetConfRelatedCalls, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible pour TAPI pour retourner des informations.

Note Si les paramètres de taille de la structure ne sont pas corrects, il est possible que les données soient remplacées. Pour plus d’informations sur la définition des tailles de structure, consultez la rubrique allocation de mémoire .

Valeur retournée

Retourne zéro si la requête réussit ou un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_NOCONFERENCE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Remarques

L’appel spécifié peut être un handle de téléconférence ou un handle pour un appel de participant. Par exemple, un appel de consultation qui n’a pas encore été ajouté à une téléconférence ne fait pas partie d’une conférence. La première entrée de la liste qui est retournée est le handle de téléconférence, les autres handles sont tous les appels des participants. L’appel spécifié est toujours l’un des appels retournés dans la liste. Les appels de la liste pour lesquels l’application ne dispose pas déjà d’un handle d’appel se voient attribuer des privilèges d’analyse ; les privilèges pour les appels pour lesquels l’application a déjà des handles sont inchangés. L’application peut utiliser lineSetCallPrivilege pour modifier le privilège de l’appel.

Si lineGetConfRelatedCalls est appelé immédiatement après l’ajout d’un appel à une conférence à l’aide de lineCompleteTransfer, lineGetConf RelatedCalls 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 a entré LINECALLSTATE_CONFERENCED avant de considérer que l’appel fait effectivement partie de la conférence (autrement dit, l’état 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 .

L’application peut appeler lineGetCallInfo et lineGetCallStatus pour chaque appel de la liste afin de déterminer les informations et les status de l’appel, respectivement.