fonction lineGetCallInfo (tapi.h)

Article
03/04/2024

La fonction lineGetCallInfo permet à une application d’obtenir des informations fixes sur l’appel spécifié.

Syntaxe

LONG lineGetCallInfo(
  HCALL          hCall,
  LPLINECALLINFO lpCallInfo
);

Paramètres

hCall

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

lpCallInfo

Pointeur vers une structure de données de taille variable de type LINECALLINFO. Une fois la demande terminée, cette structure est remplie d’informations relatives aux appels. Avant d’appeler lineGetCallInfo, 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.

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_INVALCALLHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Remarques

Une structure LINECALLINFO distincte existe pour chaque appel entrant ou sortant. La structure contient principalement des informations fixes sur l’appel. Une application serait généralement intéressée à vérifier ces informations lorsqu’elle reçoit son handle pour un appel par le message LINE_CALLSTATE , ou chaque fois qu’elle reçoit une notification par un message de LINE_CALLINFO que des parties de la structure d’informations d’appel ont changé. Ces messages fournissent le handle de l’appel en tant que paramètre.