TSPI_lineClose-Funktion (tspi.h)

Artikel
03/06/2024

Die TSPI_lineClose-Funktion schließt das angegebene Open Line-Gerät, nachdem alle ausstehenden Aufrufe und asynchronen Vorgänge auf dem Gerät abgeschlossen oder abgebrochen wurden.

Syntax

LONG TSPIAPI TSPI_lineClose(
  HDRVLINE hdLine
);

Parameter

hdLine

Das Handle des Dienstanbieters für die zu schließende Leitung. Nachdem die Zeile erfolgreich geschlossen wurde, ist dieser Handle nicht mehr gültig.

Rückgabewert

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

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Hinweise

Der Dienstanbieter muss den Abschluss für jeden asynchronen Vorgang melden. Wenn TSPI_lineClose für eine Zeile aufgerufen wird, in der asynchrone Vorgänge ausstehen, werden die Vorgänge vollständig mit einem entsprechenden Ergebnis- oder Fehlercode gemeldet, bevor diese Prozedur zurückgegeben wird.

Eine ähnliche Anforderung besteht für aktive Anrufe in der Leitung. Ausstehende Vorgänge müssen vollständig mit entsprechenden Ergebnis- oder Fehlercodes gemeldet werden. Aktive Aufrufe müssen auch gelöscht werden, falls erforderlich, und wenn dieses Verhalten durch das LINEDEVCAPFLAGS_CLOSEDROP Bit in der LINEDEVCAPS-Struktur angegeben wurde.

Nachdem diese Prozedur zurückgegeben wurde, darf der Dienstanbieter keine weiteren htCall-Aufrufe in der Zeile oder in der Zeile melden. Die Handles des Dienstanbieters für die Zeile und Aufrufe in der Zeile werden "ungültig".

Der Dienstanbieter muss auf nicht bare Ressourcen verzichten, die er reserviert, während die Leitung geöffnet ist. Beispielsweise sollte das Schließen einer Leitung, auf die über einen Comm-Port und ein Modem zugegriffen wird, dazu führen, dass der Comm-Port geschlossen wird, sodass er wieder für die Verwendung durch andere Anwendungen verfügbar ist.

Der Dienstanbieter gibt die LINE_LINEDEVSTATE Nachricht als Reaktion auf diesen Funktionsaufruf nicht aus, da die Zeile geschlossen wird und kein Interesse mehr an ihren Zustandsänderungen besteht.