fonction TSPI_lineRedirect (tspi.h)

Article
08/26/2023

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

Syntaxe

LONG TSPIAPI TSPI_lineRedirect(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCWSTR       lpszDestAddress,
  DWORD         dwCountryCode
);

Paramètres

dwRequestID

Identificateur de la requête asynchrone.

hdCall

Handle vers l’appel à rediriger. L’état de l’appel de hdCall peut être proposé.

lpszDestAddress

Pointeur vers une chaîne Unicode terminée par null qui spécifie l’adresse de destination. Cela suit le format de lien standard.

dwCountryCode

Code de pays ou de 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. 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 du ASYNC_COMPLETION correspondant 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_INVALCOUNTRYCODE, LINEERR_OPERATIONFAILED, LINEERR_INVALADDRESS, LINEERR_RESOURCEUNAVAIL.

Remarques

Le fournisseur de services ne redirige pas l’appel s’il retourne LINEERR_INVALADDRESS.

Lorsque cette fonction est appelée, le fournisseur de services dévie l’appel de l’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 l’intervention de la station appelée ; La redirection peut être effectuée sur une base d’appel par appel par une application cliente, par exemple pilotée par les informations d’ID de l’appelant. Il diffère du transfert d’appel en ce 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 à inactif. Le fournisseur de services indique le nouvel état à l’aide d’un message LINE_CALLSTATE .