TSPI_lineClose, fonction (tspi.h)
La fonction TSPI_lineClose ferme l’appareil de ligne ouvert spécifié après avoir terminé ou abandonné tous les appels en attente et les opérations asynchrones sur l’appareil.
Syntaxe
LONG TSPIAPI TSPI_lineClose(
HDRVLINE hdLine
);
Paramètres
hdLine
Handle du fournisseur de services à la ligne à fermer. Une fois la ligne fermée, ce handle n’est plus valide.
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 de chaque opération asynchrone. Si TSPI_lineClose est appelé pour une ligne sur laquelle des opérations asynchrones sont en attente, les opérations sont signalées avec un résultat ou un code d’erreur approprié avant le retour de cette procédure.
Une exigence similaire existe pour les appels actifs sur la ligne. Les opérations en attente doivent être signalées terminées avec les codes de résultat ou d’erreur appropriés. Les appels actifs doivent également être supprimés, si nécessaire, et si ce comportement a été indiqué par le bit LINEDEVCAPFLAGS_CLOSEDROP dans la structure LINEDEVCAPS .
Une fois cette procédure retournée, le fournisseur de services doit signaler plus de htCall sur la ligne ou les appels qui se trouvaient sur la ligne. Les handles du fournisseur de services pour la ligne et les appels sur la ligne deviennent « non valides ».
Le fournisseur de services doit renoncer aux ressources non partageables qu’il réserve pendant que la ligne est ouverte. Par exemple, la fermeture d’une ligne accessible via un port de communication et un modem doit entraîner la fermeture du port de communication, ce qui le rend à nouveau disponible pour d’autres applications.
Le fournisseur de services n’émet pas le message LINE_LINEDEVSTATE en réponse à cet appel de fonction, car la ligne se ferme et il n’y a plus d’intérêt pour les changements d’état.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Windows |
| En-tête | tspi.h |