fonction lineGetNewCalls (tapi.h)

Article
03/02/2024

La fonction lineGetNewCalls retourne des descripteurs d’appel aux appels sur une ligne ou une adresse spécifiée pour laquelle l’application ne dispose actuellement pas de handles. L’application se voit octroyer le privilège de surveillance pour ces appels.

Syntaxe

LONG lineGetNewCalls(
  HLINE          hLine,
  DWORD          dwAddressID,
  DWORD          dwSelect,
  LPLINECALLLIST lpCallList
);

Paramètres

hLine

Gérer sur un appareil de ligne ouverte.

dwAddressID

Adresse sur l’appareil de ligne ouverte donné. Un identificateur d’adresse est associé de manière permanente à une adresse ; l’identificateur reste constant entre les mises à niveau du système d’exploitation.

dwSelect

Sélection des appels demandés. Ce paramètre utilise une seule des constantes LINECALLSELECT_.

lpCallList

Pointeur vers une structure de données de taille variable de type LINECALLLIST. Une fois la demande terminée, les descripteurs d’appel de tous les appels sélectionnés sont retournés dans cette structure. Avant d’appeler lineGetNewCalls, l’application doit définir le membre dwTotalSize de cette structure pour indiquer la quantité de mémoire disponible à TAPI pour retourner des informations.

Note Si les paramètres de taille dans 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 demande réussit ou un nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Remarques

Une application peut utiliser lineGetNewCalls pour obtenir des handles pour les appels pour lesquels elle n’a actuellement aucun handle. L’application peut sélectionner les appels pour lesquels les handles doivent être retournés en basant cette sélection sur l’étendue (appels sur une ligne spécifiée ou appels sur une adresse spécifiée). Par exemple, une application peut demander des descripteurs d’appel à tous les appels sur une adresse donnée pour laquelle elle n’a actuellement aucun handle. L’application reçoit toujours le privilège de surveillance pour les nouveaux descripteurs d’appel. En outre, lors de l’ouverture d’une ligne, une application utilise cette fonction pour prendre connaissance des appels existants.

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. Il peut utiliser lineSetCallPrivilege pour modifier son privilège en propriétaire.