TSPI_lineCloseCall, fonction (tspi.h)
La fonction TSPI_lineCloseCall libère l’appel après avoir terminé ou abandonné toutes les opérations asynchrones en suspens sur l’appel.
Syntaxe
LONG TSPIAPI TSPI_lineCloseCall(
HDRVCALL hdCall
);
Paramètres
hdCall
Handle du fournisseur de services pour l’appel à fermer. Une fois l’appel correctement fermé, ce handle n’est plus valide. L’état d’appel peut être n’importe quel état.
Valeur retournée
Retourne 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_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL LINEERR_RESOURCEUNAVAIL.
Remarques
Le fournisseur de services doit signaler l’achèvement des opérations asynchrones. Si TSPI_lineCloseCall est appelé pour un appel sur lequel des opérations asynchrones sont en attente, les opérations doivent être signalées terminées avec un résultat ou un code d’erreur approprié avant que cette procédure ne retourne. Une fois cette procédure retournée, le fournisseur de services ne doit signaler aucun autre événement sur l’appel. Les handles du fournisseur de services pour la ligne et les appels sur la ligne deviennent « non valides ».
TAPI n’appelle pas TSPI_lineCloseCall si un fournisseur de services retourne de façon synchrone une erreur à partir d’un appel à la fonction TSPI_lineMakeCall . Mais TAPI appelle TSPI_lineCloseCall si le fournisseur de services retourne une erreur à partir de l’opération asynchrone lancée par TSPI_lineMakeCall.
S’il existe un appel actif sur la ligne au moment de TSPI_lineCloseCall, l’appel doit être supprimé si ce comportement est indiqué par le bit LINEDEVCAPFLAGS_CLOSEDROP dans la structure LINEDEVCAPS .
Si le fournisseur de services peut déterminer qu’un autre agent partage le contrôle de l’appel, par exemple dans une situation de ligne de partie avec un combiné distinct, le fournisseur de services laisse simplement le contrôle de l’appel passer à l’autre agent au lieu de le supprimer de force.
Cette fonction doit toujours réussir, sauf dans des circonstances extraordinaires. La plupart des appelants ignoreront probablement le code de retour, car ils ne pourront pas compenser les erreurs qui se produisent. Les valeurs de retour spécifiées sont plus avisées à des fins de diagnostic de développement que toute autre chose.
Cette fonction est appelée lorsque la dernière application avec un handle pour cet appel exécute lineDeallocateCall.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |