lineRedirect, fonction (tapi.h)

Article
08/26/2023

La fonction lineRedirect redirige l’appel d’offre spécifié vers l’adresse de destination spécifiée.

Syntaxe

LONG lineRedirect(
  HCALL  hCall,
  LPCSTR lpszDestAddress,
  DWORD  dwCountryCode
);

Paramètres

hCall

Gérez l’appel à rediriger. L’application doit être propriétaire de l’appel. L’état de l’appel de hCall doit être proposé.

lpszDestAddress

Pointeur vers l’adresse de destination. Cela suit le format de numéro de numérotation standard.

dwCountryCode

Code de pays/région de la partie vers laquelle l’appel est redirigé. Si la valeur 0 est spécifiée, une valeur par défaut est utilisée par l’implémentation.

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 nombre d’erreur négatif si une erreur se produit. Les valeurs de retour possibles sont les suivantes :

LINEERR_INVALADDRESS, LINEERR_NOTOWNER, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_INVALCOUNTRYCODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Remarques

La redirection d’appel permet à une application de détourner un appel d’offre vers une autre adresse sans répondre d’abord à l’appel. La redirection d’appel diffère du transfert d’appel en ce que le transfert d’appel est effectué par le commutateur sans intervention de l’application ; La redirection peut être effectuée sur une base d’appel par appel par l’application, par exemple, pilotée par les informations d’ID de l’appelant. Il diffère du transfert d’appel dans le fait que le transfert d’un appel nécessite d’abord une réponse à l’appel.

Une fois qu’un appel a été correctement redirigé, l’appel passe généralement à l’inactif.

En plus de rediriger un appel entrant, une application peut avoir la possibilité d’accepter l’appel à l’aide de lineAccept, de rejeter l’appel à l’aide de lineDrop ou de répondre à l’appel à l’aide de lineAnswer. La disponibilité de ces opérations dépend des fonctionnalités de l’appareil.