PHONE_REMOVE Nachricht
Die TAPI PHONE_REMOVE Nachricht wird gesendet, um eine Anwendung über die Entfernung (Löschung aus dem System) eines Telefongeräts zu informieren. In der Regel wird dies nicht für temporäre Entfernungen wie die Extraktion von PCMCIA-Geräten verwendet, sondern nur für dauerhafte Entfernungen, bei denen das Gerät vom Dienstanbieter nicht mehr gemeldet würde, wenn TAPI neu initialisiert würde.
Parameter
-
hDevice
-
Reserviert. Auf NULL festlegen.
-
dwCallbackInstance
-
Reserviert. Auf NULL festlegen.
-
dwParam1
-
Id des entfernten Telefongeräts.
-
dwParam2
-
Reserviert. Auf NULL festlegen.
-
dwParam3
-
Reserviert. Auf NULL festlegen.
Rückgabewert
Kein Rückgabewert.
Bemerkungen
Anwendungen TAPI Version 2.0 oder höher erhalten eine PHONE_REMOVE Nachricht. Dadurch werden sie darüber informiert, dass das Gerät aus dem System entfernt wurde. Der PHONE_REMOVE Nachricht wird auf jedem Telefonhandle eine PHONE_CLOSE Nachricht vorangestellt, wenn das Telefon in der Anwendung geöffnet war. Diese Nachricht wird an alle Anwendungen gesendet, die TAPI Version 2.0 oder höher unterstützen, die phoneInitializeEx aufgerufen haben, einschließlich anwendungen, für die zu diesem Zeitpunkt keine Telefongeräte geöffnet sind.
Ältere Anwendungen (die TAPI-Version 1.4 oder früher ausgehandelt haben) erhalten eine PHONE_STATE Nachricht, die PHONESTATE_REMOVED angibt, gefolgt von einer PHONE_CLOSE Nachricht. Im Gegensatz zur PHONE_REMOVE Nachricht können diese älteren Anwendungen diese Nachrichten jedoch nur empfangen, wenn das Telefon geöffnet ist, wenn es entfernt wird. Wenn das Telefon nicht geöffnet ist, ist ihr einziger Hinweis darauf, dass das Gerät entfernt wurde, eine PHONEERR_NODEVICE, wenn sie versuchen, auf das Gerät zuzugreifen.
Nachdem ein Gerät entfernt wurde, führt jeder Versuch, über seine Geräte-ID auf das Gerät zuzugreifen, zu einem PHONEERR_NODEVICE Fehler. Nachdem alle TAPI-Anwendungen heruntergefahren wurden, sodass TAPI neu gestartet werden kann, und wenn TAPI neu initialisiert wird, belegt das entfernte Gerät keinen Gerätebezeichner mehr.
Hinweis
Implementierung: Es ist die TAPI, die diese PHONEERR_NODEVICE Nachricht zurückgibt, nachdem eine PHONE_REMOVE Nachricht von einem Dienstanbieter empfangen wurde. es werden keine weiteren Anrufe an diesen Dienstanbieter unter Verwendung dieser Geräte-ID des Telefons getätigt.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher. |
| Header |
|