Lire en anglais

Partager via


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

            

Paramètres

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.

Valeur retournée

Pas de valeur de retour.

Notes

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.

Spécifications

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

Voir aussi

LINE_CLOSE

LINE_LINEDEVSTATE

lineInitializeEx