TSPI_lineBlindTransfer, fonction (tspi.h)
La fonction TSPI_lineBlindTransfer effectue un transfert aveugle ou en une seule étape de l’appel spécifié vers l’adresse de destination spécifiée.
Syntaxe
LONG TSPIAPI TSPI_lineBlindTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
LPCWSTR lpszDestAddress,
DWORD dwCountryCode
);
Paramètres
dwRequestID
Identificateur de la requête asynchrone.
hdCall
Handle du fournisseur de services pour l’appel à transférer. L’état d’appel de hdCall peut être connecté.
lpszDestAddress
Pointeur vers une chaîne Unicode terminée par un caractère Null identifiant l’emplacement vers lequel l’appel doit être transféré. L’adresse de destination utilise le format de numéro d’appel standard.
dwCountryCode
Code du pays ou de la région de la destination. L’implémentation doit l’utiliser pour sélectionner les protocoles de progression de l’appel pour l’adresse de destination. Si la valeur 0 est spécifiée, le fournisseur de services doit utiliser une valeur par défaut. TAPI ne valide pas dwCountryCode 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 égal à 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_INVALADDRESS, LINEERR_OPERATIONFAILED, LINEERR_ADDRESSBLOCKED, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCOUNTRYCODE.
Remarques
Le fournisseur de services n’effectue aucune numérotation s’il retourne LINEERR_INVALADDRESS.
Le transfert aveugle diffère d’un transfert de consultation en ce qu’aucun appel de consultation n’est rendu visible par TAPI. En règle générale, une fois le transfert à l’aveugle terminé, l’appel spécifié est effacé de la ligne sur laquelle il était et passe à l’état inactif . Le handle d’appel du fournisseur de services doit rester valide une fois le transfert terminé. TAPI rend ce handle invalidé lorsqu’il n’est plus intéressé par l’appel transféré à l’aide de TSPI_lineCloseCall.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |