fonction TSPI_lineCompleteCall (tspi.h)

Article
08/26/2023

La fonction TSPI_lineCompleteCall est utilisée pour spécifier la façon dont un appel qui ne peut pas être connecté normalement doit être effectué à la place. Le réseau ou le commutateur peut ne pas être en mesure d’effectuer un appel, car les ressources réseau sont occupées ou la station distante est occupée ou ne répond pas.

Syntaxe

LONG TSPIAPI TSPI_lineCompleteCall(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPDWORD       lpdwCompletionID,
  DWORD         dwCompletionMode,
  DWORD         dwMessageID
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Le handle du fournisseur de services pour l’appel dont l’achèvement est demandé. L’état de l’appel de hdCall peut être occupé, sonner ou continuer.

lpdwCompletionID

Pointeur vers un emplacement de mémoire de taille DWORD où le fournisseur de services écrit un identificateur d’achèvement. Cela identifie de manière unique une demande d’achèvement en cours sur la ligne qui contient le hdCall. En particulier, un identificateur d’achèvement devient non valide une fois la demande terminée ou annulée à l’aide de la fonction TSPI_lineUncompleteCall . Le fournisseur de services est libre de réutiliser l’identificateur d’achèvement dès qu’il devient non valide.

dwCompletionMode

La façon dont l’appel doit être effectué. Ce paramètre utilise une seule constante LINECALLCOMPLMODE_.

dwMessageID

Message à envoyer à la fin de l’appel à l’aide de LINECALLCOMPLMODE_MESSAGE. Cet identificateur sélectionne le message à partir d’un petit nombre de messages prédéfinis. Ce paramètre n’est pas validé par TAPI lorsque cette fonction est appelée.

Valeur retournée

Retourne dwRequestID ou un numéro d’erreur si une erreur se produit. Le paramètre réel lResult de la ASYNC_COMPLETION correspondante est 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_NOMEM, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLCOMPLMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALPOINTER, LINEERR_RESOURCEUNAVAIL, LINEERR_COMPLETIONOVERRUN, LINEERR_INVALMESSAGEID.

Remarques

Cette fonction est considérée comme terminée lorsque la demande est acceptée par le réseau ou le commutateur ; pas lorsque la demande est entièrement terminée de la manière spécifiée. Lorsque la station ou le réseau appelé entre dans un état où l’appel peut être effectué comme demandé, le fournisseur de services doit envoyer un message LINE_CALLSTATE avec l’état de l’appel égal à l’offre. L’enregistrement LINECALLINFO de l’appel répertorie la raison de l’appel en tant que CALLCOMPLETION et fournit également l’identificateur d’achèvement. Il est possible d’avoir plusieurs demandes de fin d’appel en attente à tout moment ; le nombre maximal dépend de l’appareil. L’identificateur d’achèvement est également utilisé pour faire référence à chaque demande individuelle afin que les demandes puissent être annulées en appelant TSPI_lineUncompleteCall.