PHONE_REMOVE message
Le message de PHONE_REMOVE TAPI est envoyé pour informer une application de la suppression (suppression du système) d’un appareil téléphonique. 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 téléphonique 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 TAPI version 2.0 ou ultérieure reçoivent un message PHONE_REMOVE . Cela les informe que l’appareil a été supprimé du système. Le message PHONE_REMOVE est précédé d’un message PHONE_CLOSE sur chaque handle de téléphone, si l’application avait le téléphone ouvert. Ce message est envoyé à toutes les applications prenant en charge TAPI version 2.0 ou ultérieure qui ont appelé phoneInitializeEx, y compris celles qui n’ont pas d’appareil téléphonique ouvert à ce moment-là.
Les applications plus anciennes (qui négociaient TAPI version 1.4 ou antérieure) reçoivent un message PHONE_STATE spécifiant PHONESTATE_REMOVED, suivi d’un message PHONE_CLOSE . Toutefois, contrairement au message PHONE_REMOVE , ces applications plus anciennes peuvent recevoir ces messages uniquement si le téléphone est ouvert lorsqu’il est supprimé. S’ils n’ont pas le téléphone ouvert, leur seule indication que l’appareil a été supprimé serait de recevoir une PHONEERR_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 PHONEERR_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 ce message PHONEERR_NODEVICE après la réception d’un message PHONE_REMOVE d’un fournisseur de services ; aucun autre appel n’est effectué à ce fournisseur de services à l’aide de cet identificateur d’appareil téléphonique.
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 2.0 ou version ultérieure |
| En-tête |
|