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 |
|