LINE_CLOSE message
Le message tapi LINE_CLOSE est envoyé lorsque l’appareil de ligne spécifié a été fermé de force. Le handle d’appareil de ligne ou tous les handles d’appel pour les appels sur la ligne ne sont plus valides une fois ce message envoyé.
-
hDevice
-
Handle de l’appareil de ligne qui a été fermé. Ce handle n’est plus valide.
-
dwCallbackInstance
-
Le rappel instance fourni lors de l’ouverture de la ligne.
-
dwParam1
-
Inutilisé.
-
dwParam2
-
Inutilisé.
-
dwParam3
-
Inutilisé.
Pas de valeur de retour.
Le message LINE_CLOSE n’est envoyé à une application qu’une fois que le fournisseur de services TAPI (TSP) a fermé de force une ligne ouverte. Si la ligne peut ou non être rouverte immédiatement après une fermeture forcée est spécifique à l’appareil.
La condition à l’origine peut être un changement d’état important, une erreur matérielle, une perte de connexion à un serveur ou même potentiellement pour empêcher une application unique de monopoliser un appareil de ligne pendant trop longtemps. Un périphérique de ligne peut également être fermé de force une fois que l’utilisateur a modifié la configuration de cette ligne ou de son pilote. Si l’utilisateur souhaite que les modifications de configuration soient effectives immédiatement (par opposition à après le prochain redémarrage du système) et qu’elles affectent la vue actuelle de l’application de l’appareil (par exemple, une modification des fonctionnalités de l’appareil), un fournisseur de services peut fermer de force l’appareil de ligne.
Condition requise | Valeur |
---|---|
Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
En-tête |
|