fonction lineBlindTransfer (tapi.h)

Article
08/26/2023

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

Syntaxe

LONG lineBlindTransfer(
  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 du pays ou de la région de la destination. Cela est utilisé par l’implémentation pour sélectionner les protocoles de progression de l’appel 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 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_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 en ce qu’aucun appel de consultation n’est rendu visible à la demande. 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 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é.