lineRedirectA, fonction (tapi.h)

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

Syntaxe

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

Paramètres

hCall

Gérer l’appel à rediriger. L’application doit être propriétaire de l’appel. L’état d’appel de hCall doit être offre.

lpszDestAddress

Pointeur vers l’adresse de destination. Ceci suit le format de numéro rendez-vous standard.

dwCountryCode

Code pays/région du tiers vers lequel 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 de retour

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 de 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_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évier 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 dans ce transfert d’appel est effectuée par le commutateur sans l’implication 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 lequel le transfert d’un appel nécessite que l’appel soit d’abord répondu.

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

Outre la redirection d’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.

Note

L’en-tête tapi.h définit lineRedirect en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
plateforme cible	Windows
d’en-tête	tapi.h
bibliothèque	Tapi32.lib
DLL	Tapi32.dll

Voir aussi

LINE_REPLY

Vue d’ensemble de la redirection

fonctions de service de ligne supplémentaires

vue d’ensemble des informations de référence sur TAPI 2.2

lineAccept

lineAnswer

lineDrop