fonction lineGetCallStatus (tapi.h)

Article
08/26/2023

La fonction lineGetCallStatus retourne la status actuelle de l’appel spécifié.

Syntaxe

LONG lineGetCallStatus(
  HCALL            hCall,
  LPLINECALLSTATUS lpCallStatus
);

Paramètres

hCall

Gérer l’appel à interroger. L’état d’appel de hCall peut être n’importe quel état.

lpCallStatus

Pointeur vers une structure de données de taille variable de type LINECALLSTATUS. Une fois la demande terminée, cette structure est remplie d’informations status d’appel. Avant d’appeler lineGetCallStatus, 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_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Remarques

La fonction lineGetCallStatus retourne la status dynamique d’un appel, tandis que lineGetCallInfo renvoie principalement des informations statiques sur un appel. Les informations de status d’appel incluent l’état actuel de l’appel, des informations détaillées sur le mode de l’appel dans cet état (le cas échéant), ainsi qu’une liste des fonctions d’API disponibles que l’application peut appeler sur l’appel pendant que l’appel est dans cet état. Une application serait généralement intéressée à demander ces informations lorsqu’elle reçoit une notification concernant un changement d’état d’appel par le message LINE_CALLSTATE.