LINE_CLOSE Nachricht

Die TAPI-LINE_CLOSE-Nachricht wird gesendet, wenn das angegebene Leitungsgerät gewaltsam geschlossen wurde. Das Zeilengerätehandle oder alle Anrufhandles für Anrufe in der Leitung sind nicht mehr gültig, sobald diese Nachricht gesendet wurde.

            

Parameter

hGeräte

Ein Handle für das geschlossene Leitungsgerät. Dieses Handle ist nicht mehr gültig.

dwCallbackInstance

Der Rückruf instance beim Öffnen der Zeile angegeben.

dwParam1

Nicht verwendet.

dwParam2

Nicht verwendet.

dwParam3

Nicht verwendet.

Rückgabewert

Kein Rückgabewert.

Bemerkungen

Die LINE_CLOSE Nachricht wird erst an jede Anwendung gesendet, nachdem der TAPI-Dienstanbieter (TSP) eine offene Zeile gewaltsam geschlossen hat. Ob die Leitung unmittelbar nach einer erzwungenen Schließung wieder geöffnet werden kann, ist gerätespezifisch.

Die ursachende Bedingung kann eine signifikante Änderung des Zustands, ein Hardwarefehler, ein Verlust der Verbindung mit einem Server oder sogar potenziell verhindern, dass eine einzelne Anwendung ein Leitungsgerät zu lange monopolisiert. Ein Leitungsgerät kann auch gewaltsam geschlossen werden, nachdem der Benutzer die Konfiguration dieser Leitung oder ihres Treibers geändert hat. Wenn der Benutzer möchte, dass die Konfigurationsänderungen sofort wirksam sind (im Gegensatz zu dem nächsten Systemneustart), und sie sich auf die aktuelle Ansicht des Geräts der Anwendung auswirken (z. B. eine Änderung der Gerätefunktionen), kann ein Dienstanbieter das Leitungsgerät gewaltsam schließen.

Anforderungen

Anforderung Wert
TAPI-Version
Erfordert TAPI 2.0 oder höher
Header
Tapi.h