LINE_REMOVE Nachricht
Die TAPI LINE_REMOVE Nachricht wird gesendet, um eine Anwendung über das Entfernen (Löschen aus dem System) eines Leitungsgerä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
-
Bezeichner des entfernten Leitungsgeräts.
-
dwParam2
-
Reserviert. Auf NULL festlegen.
-
dwParam3
-
Reserviert. Auf NULL festlegen.
Rückgabewert
Kein Rückgabewert.
Bemerkungen
Anwendungen, die TAPI-Version 2.0 oder höher unterstützen, erhalten eine LINE_REMOVE Nachricht. Dadurch werden sie darüber informiert, dass das Gerät aus dem System entfernt wurde. Der LINE_REMOVE Nachricht wird in jedem Zeilenhandle eine LINE_CLOSE Nachricht vorangestellt, wenn die Zeile in der Anwendung geöffnet war. Diese Nachricht wird an alle Anwendungen gesendet, die TAPI Version 2.0 oder höher unterstützen, die lineInitializeEx aufgerufen haben, einschließlich anwendungen, für die zu diesem Zeitpunkt keine Leitungsgeräte geöffnet sind.
Ältere Anwendungen erhalten eine LINE_LINEDEVSTATE-Nachricht , die LINEDEVSTATE_REMOVED angibt, gefolgt von einer LINE_CLOSE-Nachricht. Im Gegensatz zur LINE_REMOVE Nachricht können diese älteren Anwendungen diese Nachrichten jedoch nur empfangen, wenn die Zeile geöffnet ist, wenn sie entfernt wird. Wenn die Leitung nicht geöffnet ist, wird beim Versuch, auf das Gerät zuzugreifen, nur ein LINEERR_NODEVICE-Fehler angezeigt, dass das Gerät entfernt wurde.
Nachdem ein Gerät entfernt wurde, führt jeder Versuch, über seine Geräte-ID auf das Gerät zuzugreifen, zu einem LINEERR_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 tapi, die diese LINEERR_NODEVICE zurückgibt. nachdem eine LINE_REMOVE Nachricht von einem Dienstanbieter empfangen wurde; es werden keine weiteren Aufrufe an diesen Dienstanbieter unter Verwendung dieser Leitungsgeräte-ID durchgeführt.
Anforderungen
| Anforderung | Wert |
|---|---|
| TAPI-Version |
Erfordert TAPI 2.0 oder höher. |
| Header |
|