Share via


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é.

            

Paramètres

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é.

Valeur retournée

Pas de valeur de retour.

Notes

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.

Spécifications

Condition requise Valeur
Version TAPI
Nécessite TAPI 2.0 ou version ultérieure
En-tête
Tapi.h