lineDeallocateCall-Funktion (tapi.h)

Artikel
08/26/2023

Die lineDeallocateCall-Funktion löst die Zuordnung des angegebenen Aufrufhandles.

Syntax

LONG lineDeallocateCall(
  HCALL hCall
);

Parameter

hCall

Das zu behandelnde Anrufhandle. Eine Anwendung mit Überwachungsberechtigungen für einen Anruf kann immer die Zuordnung des Handles für diesen Anruf behandeln. Eine Anwendung mit Besitzerberechtigungen für einen Anruf kann die Zuordnung ihres Handles beheben, es sei denn, sie ist der alleinige Besitzer des Anrufs und der Aufruf befindet sich nicht im Leerlaufzustand . Das Anrufhandle ist nach der Zuordnung 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_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_UNINITIALIZED.

Hinweise

Die Deallocation wirkt sich nicht auf den Anrufstatus des physischen Anrufs aus. Es gibt jedoch interne Ressourcen im Zusammenhang mit dem Aufruf frei.

Wenn die Anwendung in API-Versionen vor 2.0 der alleinige Besitzer eines Aufrufs ist und sich der Aufruf nicht im Leerlaufzustand befindet, wird LINEERR_INVALCALLSTATE zurückgegeben. In diesem Fall kann die Anwendung den Anruf zunächst mithilfe von lineDrop abbrechen und anschließend den Anrufhandle ordnet. Eine Anwendung, die über Überwachungsberechtigungen für einen Anruf verfügt, kann immer die Zuordnung des Handles für den Anruf aufheben.

In API-Versionen 2.0 oder höher kann der alleinige Besitzer des Aufrufs die Zuordnung des Handles durchführen, auch wenn sich der Aufruf nicht im Leerlaufzustand befindet . Dadurch wird die verteilte Steuerung des Aufrufs in einer Client-/Serverumgebung ermöglicht.

Hinweis Wenn der Anruf ohne Besitzer verlassen wird, kann dies dazu führen, dass der Benutzer den Anruf nicht beenden kann, wenn Überwachungsanwendungen geöffnet sind, die TAPI daran hindern , TSPI_lineCloseCall aufzurufen. Verwenden Sie dieses Feature nur, wenn die Anwendung feststellen kann, dass der Aufruf vom Benutzer extern gesteuert werden kann. Weitere Informationen finden Sie unter LINEADDRCAPFLAGS_CLOSEDROP.

Wenn in API-Versionen vor 2.0 die lineDeallocateCall-Funktion die Zuordnung eines Aufrufhandles erledigt, wird auch die weitere Verarbeitung aller ausstehenden LINE_REPLY Nachrichten für den Aufruf angehalten. Eine Anwendung muss so konzipiert sein, dass sie nicht unbegrenzt auf LINE_REPLY Nachrichten für jeden entsprechenden Aufruf einer asynchronen Funktion wartet, wenn sie auch die lineDeallocateCall-Funktion verwendet, um die Zuordnung von Handles zu beheben.

In API-Versionen 2.0 oder höher setzt lineDeallocateCall keine ausstehenden LINE_REPLY Nachrichten an. Jede asynchrone Funktion, die eine dwRequestID an die Anwendung zurückgibt, führt immer zur Übermittlung der zugeordneten LINE_REPLY Nachricht, es sei denn, die Anwendung ruft lineShutdown auf.