LINE_REMOVE message
Le message de LINE_REMOVE TAPI est envoyé pour informer une application de la suppression (suppression du système) d’un périphérique de ligne. En règle générale, cela n’est pas utilisé pour les suppressions temporaires, telles que l’extraction d’appareils PCMCIA, mais uniquement pour les suppressions définitives dans lesquelles l’appareil ne serait plus signalé par le fournisseur de services si tapI était réinitialisé.
-
hDevice
-
Réservé. Définit la valeur zéro.
-
dwCallbackInstance
-
Réservé. Définit la valeur zéro.
-
dwParam1
-
Identificateur de l’appareil de ligne qui a été supprimé.
-
dwParam2
-
Réservé. Définit la valeur zéro.
-
dwParam3
-
Réservé. Définit la valeur zéro.
Pas de valeur de retour.
Les applications prenant en charge TAPI version 2.0 ou ultérieure reçoivent un message LINE_REMOVE . Cela les informe que l’appareil a été supprimé du système. Le message LINE_REMOVE est précédé d’un message LINE_CLOSE sur chaque descripteur de ligne, si l’application avait la ligne ouverte. Ce message est envoyé à toutes les applications prenant en charge TAPI version 2.0 ou ultérieure qui ont appelé lineInitializeEx, y compris celles qui n’ont pas d’appareils de ligne ouverts à ce moment-là.
Les applications plus anciennes reçoivent un message LINE_LINEDEVSTATE spécifiant LINEDEVSTATE_REMOVED, suivi d’un message LINE_CLOSE. Toutefois, contrairement au message LINE_REMOVE , ces applications plus anciennes peuvent recevoir ces messages uniquement si la ligne est ouverte lorsqu’elle est supprimée. S’ils n’ont pas la ligne ouverte, leur seule indication que l’appareil a été supprimé reçoit une erreur LINEERR_NODEVICE lorsqu’ils tentent d’accéder à l’appareil.
Une fois qu’un appareil a été supprimé, toute tentative d’accès à l’appareil par son identificateur d’appareil génère une erreur LINEERR_NODEVICE. Une fois que toutes les applications TAPI ont été arrêtées afin que TAPI puisse redémarrer, et lorsque TAPI est réinitialisé, l’appareil supprimé n’occupe plus d’identificateur d’appareil.
Notes
Implémentation : c’est TAPI qui retourne cette LINEERR_NODEVICE ; après la réception d’un message LINE_REMOVE d’un fournisseur de services ; aucun autre appel n’est effectué à ce fournisseur de services à l’aide de cet identificateur d’appareil de ligne.
Condition requise | Valeur |
---|---|
Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
En-tête |
|