lineDrop-Funktion (tapi.h)

Artikel
03/02/2024

Die lineDrop-Funktion löscht den angegebenen Aufruf oder trennt ihn. Die Anwendung hat die Möglichkeit, Benutzer-/Benutzerinformationen anzugeben, die im Rahmen der Verbindungstrennung übertragen werden sollen.

Syntax

LONG lineDrop(
  HCALL  hCall,
  LPCSTR lpsUserUserInfo,
  DWORD  dwSize
);

Parameter

hCall

Handle für den zu verworfenen Aufruf. Die Anwendung muss ein Besitzer des Anrufs sein. Der Aufrufstatus von hCall kann ein beliebiger Zustand mit Ausnahme des Leerlaufs sein.

lpsUserUserInfo

Zeiger auf eine Zeichenfolge, die Benutzer-/Benutzerinformationen enthält, die im Rahmen der Verbindungstrennung an die Remotepartei gesendet werden sollen. Dieser Zeiger kann NULL belassen, wenn keine Benutzer-/Benutzerinformationen gesendet werden sollen. Benutzer-/Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS). Das Protokoll-Diskriminatorfeld für die Benutzer-/Benutzerinformationen sollte bei Bedarf als erstes Byte des Puffers angezeigt werden, auf den lpsUserUserInfo verweist, und muss in dwSize berücksichtigt werden.

dwSize

Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo in Byte. Wenn lpsUserUserInfoNULL ist, werden keine Benutzer-/Benutzerinformationen an die aufrufende Seite gesendet, und dwSize wird ignoriert.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_NOTOWNER, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_USERUSERINFOTOOBIG, LINEERR_INVALCALLSTATE, LINEERR_UNINITIALIZED.

Hinweise

Beim Aufrufen von lineDrop können auch verwandte Aufrufe betroffen sein. Durch das Löschen einer Telefonkonferenz können beispielsweise alle einzelnen teilnehmenden Anrufe gelöscht werden. LINE_CALLSTATE Nachrichten werden für alle Aufrufe, deren Anrufstatus betroffen ist, an die Anwendung gesendet. Ein gelöschter Aufruf wechselt in der Regel in den Leerlaufzustand . Das Aufrufen von lineDrop bei einem Aufruf im Angebotszustand lehnt den Aufruf ab. Nicht alle Telefonnetze bieten diese Funktion.

Ein Aufruf im Zustand "onholdpending" wird in der Regel in den Zustand "Verbunden" zurückgesetzt. Wenn Der Anbieter (und der Wechsel) die Konferenzbrücke für eine Telefonkonferenz an den Dritten für eine Telefonkonferenz oder beim Entfernen des Dritten in einer zuvor eingerichteten Telefonkonferenz absetzen, kann der Anbieter (und wechsel) die Konferenzbrücke freigeben und den Anruf zurück zu einem normalen Zwei-Parteien-Anruf rückgängig machen. Wenn dies der Fall ist, wechselt hConfCall in den Leerlaufzustand , und der einzige verbleibende teilnehmende Aufruf wechselt in den Zustand verbunden . Einige Schalter "heben" den anderen Aufruf automatisch auf.

Die Anwendung hat die Möglichkeit, Benutzer-/Benutzerinformationen zum Zeitpunkt des Ablegens zu senden. Selbst wenn Benutzer-Benutzer-Informationen gesendet werden können, gibt es keine Garantie, dass das Netzwerk diese Informationen an die Remotepartei übermittelt.

In verschiedenen Überbrückungs- oder Parteileitungskonfigurationen, wenn mehrere Parteien im Gespräch sind, löscht lineDrop den Anruf möglicherweise nicht. In einer überbrückten Situation kann beispielsweise ein lineDrop-Vorgang den Anruf nicht tatsächlich abbrechen, da die status anderer Stationen des Anrufs steuern kann. Stattdessen kann der Anruf einfach in den LINECONNECTEDMODE_INACTIVE-Modus geändert werden, wenn er an anderen Stationen verbunden bleibt.