lineClose-Funktion (tapi.h)

Artikel
08/26/2023

Die lineClose-Funktion schließt das angegebene Open Line-Gerät.

Syntax

LONG lineClose(
  HLINE hLine
);

Parameter

hLine

Handle für das open line-Gerät, das geschlossen werden soll. Nachdem die Zeile erfolgreich geschlossen wurde, ist dieser Handle nicht mehr gültig.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL.

Hinweise

Wenn eine Anwendung lineClose aufruft, während sie noch aktive Aufrufe in der geöffneten Zeile aufweist, wird der Besitz dieser Aufrufe der Anwendung widerrufen. Wenn die Anwendung der alleinige Besitzer dieser Aufrufe war, werden auch die Aufrufe gelöscht. Es ist eine gute Programmierpraxis für eine Anwendung, die ihr gehörten Aufrufe in einer geöffneten Zeile zu entsorgen, indem sie den Besitz explizit aufgibt und/oder diese Aufrufe vor dem Schließen der Zeile verwirft.

Wenn die Zeile erfolgreich geschlossen wurde, wird eine LINE_LINEDEVSTATE Nachricht an alle Anwendungen gesendet, die die Zeile status von Änderungen zum Öffnen/Schließen überwachen. Ausstehende asynchrone Antworten werden unterdrückt.

Dienstanbieter finden es möglicherweise nützlich oder notwendig, Leitungsgeräte von einer Anwendung mit geöffneter Leitung zurückzufordern. Dies kann nützlich sein, um zu verhindern, dass eine Anwendung das Leitungsgerät zu lange monopolisiert. In diesem Fall wird eine LINE_CLOSE Nachricht an die Anwendung gesendet, in der das Zeilenhandle des geschlossenen Leitungsgeräts angegeben wird.

Die lineOpen-Funktion weist der aufrufenden Anwendung Ressourcen zu, und Anwendungen können daran gehindert werden, eine Zeile zu öffnen, wenn Ressourcen nicht verfügbar sind. Daher sollte eine Anwendung, die nur gelegentlich ein Leitungsgerät verwendet (z. B. für ausgehende Anrufe), die Leitung schließen, um Ressourcen freizugeben und anderen Anwendungen das Öffnen der Leitung zu ermöglichen.