TSPI_lineCloseCall-Funktion (tspi.h)

Die TSPI_lineCloseCall-Funktion löst die Zuordnung des Aufrufs auf, nachdem alle ausstehenden asynchronen Vorgänge für den Aufruf abgeschlossen oder abgebrochen wurden.

Syntax

LONG TSPIAPI TSPI_lineCloseCall(
  HDRVCALL hdCall
);

Parameter

hdCall

Das Handle des Dienstanbieters für den zu schließenden Aufruf. Nachdem der Aufruf erfolgreich geschlossen wurde, ist dieses Handle nicht mehr gültig. Der Aufrufzustand kann ein beliebiger Zustand sein.

Rückgabewert

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

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Hinweise

Der Dienstanbieter muss den Abschluss für asynchrone Vorgänge melden. Wenn TSPI_lineCloseCall für einen Aufruf aufgerufen wird, für den asynchrone Vorgänge ausstehen, sollten die Vorgänge vollständig mit einem entsprechenden Ergebnis- oder Fehlercode gemeldet werden, bevor diese Prozedur zurückgegeben wird. Nachdem diese Prozedur zurückgegeben wurde, darf der Dienstanbieter keine weiteren Ereignisse für den Aufruf melden. Die Handles des Dienstanbieters für die Leitung und Aufrufe in der Zeile werden "ungültig".

TAPI ruft TSPI_lineCloseCall nicht auf, wenn ein Dienstanbieter synchron einen Fehler aus einem Aufruf der TSPI_lineMakeCall-Funktion zurückgibt. TAPI ruft jedoch TSPI_lineCloseCall auf, wenn der Dienstanbieter einen Fehler aus dem von TSPI_lineMakeCall initiierten asynchronen Vorgang zurückgibt.

Wenn zum Zeitpunkt der TSPI_lineCloseCall ein aktiver Aufruf in der Zeile vorhanden ist, muss der Aufruf gelöscht werden, wenn dieses Verhalten durch das LINEDEVCAPFLAGS_CLOSEDROP Bit in der LINEDEVCAPS-Struktur angegeben wird.

Wenn der Dienstanbieter feststellen kann, dass es eine andere Agent-Freigabesteuerung für den Anruf gibt, z. B. in einer Partyzeilensituation mit einem separaten Handset, lässt der Dienstanbieter einfach die Kontrolle über den Anruf an den anderen Agent zu, anstatt ihn zwangsumzuwerfen.

Diese Funktion sollte immer erfolgreich sein, außer unter außergewöhnlichen Umständen. Die meisten Aufrufer ignorieren wahrscheinlich den Rückgabecode, da sie nicht in der Lage sind, auftretende Fehler zu kompensieren. Die angegebenen Rückgabewerte sind für Entwicklungsdiagnosezwecke besser geeignet als alles andere.

Diese Funktion wird aufgerufen, wenn die letzte Anwendung mit einem Handle für diesen Aufruf lineDeallocateCall ausführt.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	tspi.h

Weitere Informationen

LINEDEVCAPS

TSPI_lineMakeCall