TSPI_lineDrop-Funktion (tspi.h)

Artikel
03/06/2024

Die TSPI_lineDrop-Funktion löscht den angegebenen Aufruf oder trennt ihn. Benutzer-Benutzer-Informationen können optional im Rahmen der Anruftrennung übertragen werden. Diese Funktion kann von der Anwendung jederzeit aufgerufen werden. Wenn TSPI_lineDrop zurückgibt, sollte sich der Aufruf im Leerlauf befinden.

Syntax

LONG TSPIAPI TSPI_lineDrop(
  DRV_REQUESTID dwRequestID,
  HDRVCALL      hdCall,
  LPCSTR        lpsUserUserInfo,
  DWORD         dwSize
);

Parameter

dwRequestID

Der Bezeichner der asynchronen Anforderung.

hdCall

Das Handle des Dienstanbieters für den zu verworfenen Anruf. Der Aufrufstatus von hdCall kann ein beliebiger Zustand mit Ausnahme des Leerlaufs sein.

lpsUserUserInfo

Dieser Zeiger ist nur gültig, wenn dwSize ungleich null ist. Es gibt einen Zeiger auf eine NULL-endende Zeichenfolge an, die Benutzer-Benutzer-Informationen enthält, die im Rahmen der Verbindungstrennung an die Remotepartei gesendet werden sollen. Dieser Zeiger ist NULL , wenn keine Benutzer-/Benutzerinformationen gesendet werden sollen. Benutzer-/Benutzerinformationen werden nur gesendet, wenn sie vom zugrunde liegenden Netzwerk unterstützt werden (siehe LINEDEVCAPS).

dwSize

Die Größe der Benutzer-Benutzer-Informationen in lpsUserUserInfo in Byte. Wenn lpsUserUserInfoNULL ist, wird dwSize ignoriert.

Rückgabewert

Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist null, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_USERUSERINFOTOOBIG, LINEERR_OPERATIONUNAVAIL.

Hinweise

Der Dienstanbieter gibt LINEERR_INVALCALLSTATE zurück, wenn der aktuelle Zustand des Aufrufs das Ablassen des Anrufs nicht zulässt.

Beim Aufrufen TSPI_lineDrop können auch verwandte Anrufe betroffen sein. Wenn Sie beispielsweise eine Telefonkonferenz ablegen, können alle einzelnen teilnehmenden Anrufe gelöscht werden. LINE_CALLSTATE Nachrichten werden für alle Anrufe, deren Anrufstatus betroffen ist, an TAPI gesendet. In der Regel wechselt ein gelöschter Aufruf in den Leerlaufzustand . Das Aufrufen TSPI_lineDrop bei einem Anruf im Angebotszustand lehnt den Anruf ab. Nicht alle Telefonnetze bieten diese Funktion.

In Situationen, in denen es sich bei dem abzugebenden Anruf um einen Beratungsanruf handelt, der während der Übertragung oder der Telefonkonferenz eingerichtet wurde, wird der ursprüngliche Anruf, der im Zustand OnHoldPending platziert wurde, wieder mit verbunden und in der Regel wieder in den Zustand des verbundenen Anrufs wechselt.

TAPI 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.

Hinweis In verschiedenen Überbrückungs- oder Partyleitungskonfigurationen, wenn mehrere Parteien im Gespräch sind, TSPI_lineDrop den Anruf möglicherweise nicht wirklich löschen.