lineBlindTransferA, fonction (tapi.h)

La fonction lineBlindTransfer effectue un transfert aveugle ou à étape unique de l’appel spécifié à l’adresse de destination spécifiée.

Syntaxe

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

Paramètres

hCall

Gérer l’appel à transférer. L’application doit être propriétaire de cet appel. L’état d’appel de hCall doit être connecté.

lpszDestAddress

TBD

dwCountryCode

Code pays ou région de la destination. Cette méthode est utilisée par l’implémentation pour sélectionner les protocoles de progression des appels pour l’adresse de destination. Si la valeur 0 est spécifiée, un protocole de progression des appels par défaut défini par le fournisseur de services est utilisé.

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_INVALCALLHANDLE, LINEERR_INVALCOUNTRYCODE, LINEERR_INVALCALLSTATE, LINEERR_INVALPOINTER, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALADDRESS, LINEERR_UNINITIALIZED, LINEERR_ADDRESSBLOCKED, LINEERR_OPERATIONFAILED.

Remarques

Si LINEERR_INVALADDRESS est retourné, aucune numérotation ne se produit.

Le transfert aveugle diffère d’un transfert de consultation dans le fait qu’aucun appel de consultation n’est rendu visible par l’application. Une fois le transfert aveugle terminé, l’appel spécifié est généralement effacé de la ligne de l’application et passe à l’état de inactif.

Le handle d’appel de l’application reste valide une fois le transfert terminé. L’application doit libérer son handle à l’aide de lineDeallocateCall lorsqu’elle n’est plus intéressée par l’appel transféré.

Note

L’en-tête tapi.h définit lineBlindTransfer comme 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

fonctions de service de ligne supplémentaires

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

Vue d’ensemble du transfert de

lineDeallocateCall