fonction lineCompleteCall (tapi.h)

Article
03/04/2024

La fonction lineCompleteCall spécifie comment un appel qui n’a pas pu ê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. L’application peut demander que l’appel soit terminé de plusieurs manières.

Syntaxe

LONG lineCompleteCall(
  HCALL   hCall,
  LPDWORD lpdwCompletionID,
  DWORD   dwCompletionMode,
  DWORD   dwMessageID
);

Paramètres

hCall

Gérez l’appel dont l’achèvement est demandé. L’application doit être propriétaire de l’appel. L’état de l’appel de hCall doit être occupé ou ringback.

lpdwCompletionID

Pointeur vers un emplacement de mémoire de taille DWORD. L’identificateur d’achèvement est utilisé pour identifier les demandes d’achèvement individuelles en cours. Un identificateur d’achèvement devient non valide et peut être réutilisé une fois la demande terminée ou après l’annulation d’une demande en suspens.

dwCompletionMode

Façon dont l’appel doit être effectué. Ce paramètre utilise une seule des constantes 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.

Valeur retournée

Retourne un identificateur de requête positif si la fonction est terminée de manière asynchrone, ou un numéro d’erreur négatif si une erreur se produit. Le paramètre dwParam2 du message LINE_REPLY correspondant est égal à zéro si la fonction réussit ou s’il s’agit d’un numéro d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_COMPLETIONOVERRUN, LINEERR_NOMEM, LINEERR_INVALCALLCOMPLMODE, LINEERR_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMESSAGEID, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED.

Remarques

Cette fonction est considérée comme terminée lorsque la demande a été 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. Une fois cette fonction terminée, l’appel passe généralement à inactif. Lorsque la station ou le réseau appelé entre dans un état où l’appel peut être effectué comme demandé, l’application est avertie par 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 ; 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 lineUncompleteCall.