Auf Englisch lesen

Freigeben über


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
Tapi.h

Siehe auch

LINE_CLOSE

LINE_LINEDEVSTATE

lineInitializeEx