lineSetupTransfer-Funktion (tapi.h)

Artikel
08/26/2023

Die lineSetupTransfer-Funktion initiiert eine Übertragung des durch den hCall-Parameter angegebenen Aufrufs . Sie richtet einen Beratungsanruf lphConsultCall ein, über den die Partei gewählt werden kann, die zum Ziel der Übertragung werden kann. Die Anwendung erhält besitzerrechte für den lphConsultCall-Parameter .

Syntax

LONG lineSetupTransfer(
  HCALL                  hCall,
  LPHCALL                lphConsultCall,
  LPLINECALLPARAMS const lpCallParams
);

Parameter

hCall

Handle an den zu übertragenden Anruf. Die Anwendung muss ein Besitzer des Anrufs sein. Der Anrufstatus von hCall muss verbunden sein.

lphConsultCall

Zeiger auf ein hCall-Handle . Dieser Ort wird dann mit einem Handle geladen, der den temporären Konsultationsaufruf identifiziert. Beim Einrichten eines Anrufs für die Überweisung wird automatisch ein Beratungsanruf zugeordnet, der es lineDial ermöglicht, die Adresse zu wählen, die dem neuen Übertragungsziel des Anrufs zugeordnet ist. Die ursprüngliche Partei kann ein Gespräch über diesen Konsultationsaufruf führen, bevor die Übertragung abgeschlossen ist. Der Aufrufstatus von hConsultCall ist nicht zutreffend.

Dieser Übertragungsvorgang ist für einige Leitungsgeräte möglicherweise nicht gültig. Möglicherweise muss die Anwendung den neuen Konsultationsaufruf ignorieren und einen vorhandenen gehaltenen Anruf (mithilfe von lineUnhold) aufheben, um das Ziel der Übertragung zu identifizieren. Bei Schaltern, die die adressübergreifende Anrufübertragung unterstützen, kann der Beratungsanruf an einer anderen Adresse als dem zu übertragenden Anruf vorhanden sein. Es kann auch erforderlich sein, dass der Konsultationsaufruf als völlig neuer Anruf per LineMakeCall zum Ziel der Übertragung eingerichtet wird. Welche Übertragungsformen verfügbar sind, wird in den Adressfunktionen des Aufrufs angegeben.

lpCallParams

Zeiger auf eine LINECALLPARAMS-Struktur , die die Aufrufparameter enthält, die beim Einrichten des Konsultationsaufrufs verwendet werden sollen. Dieser Parameter kann auf NULL festgelegt werden, wenn keine speziellen Aufrufsetupparameter gewünscht sind.

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_BEARERMODEUNAVAIL, LINEERR_INVALRATE, LINEERR_CALLUNAVAIL, LINEERR_NOMEM, LINEERR_INUSE, LINEERR_NOTOWNER, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLPARAMS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_STRUCTURETOOSMALL, LINEERR_INVALLINESTATE, LINEERR_UNINITIALIZED, LINEERR_INVALMEDIAMODE, LINEERR_USERUSERINFOTOOBIG, LINEERR_ INVALPOINTER.

Hinweise

Die lineSetupTransfer-Funktion richtet die Übertragung des von hCall angegebenen Aufrufs ein. In der Einrichtungsphase einer Übertragung wird ein Konsultationsgespräch eingerichtet, bei dem der Antrag die Adresse des Zielorts (die zu übermittelnde Partei) an den Switch senden kann, während der zu übertragende Anruf in der Warteschleife gehalten wird. Dieser neue Anruf wird als Beratungsanruf (hConsultCall) bezeichnet und kann unabhängig vom ursprünglichen Anruf abgelegt oder anderweitig bearbeitet werden.

Wenn der Konsultationsanruf den Anrufstatus erreicht hat, kann die Anwendung die Übertragung des Anrufs fortsetzen, indem sie entweder die Zieladresse wählt und den Fortschritt nachverfolgt oder einen vorhandenen Anruf aufhebt. Die Übertragung des ursprünglichen Aufrufs an das ausgewählte Ziel wird mithilfe von lineCompleteTransfer abgeschlossen.

Während der Konsultationsaufruf vorhanden ist, wechselt der ursprüngliche Aufruf in der Regel in den Zustand onholdPendingTransfer . Die Anwendung kann möglicherweise mit lineSwapHold zwischen dem Konsultationsaufruf und dem ursprünglichen Anruf wechseln. Ein Beratungsgespräch kann abgebrochen werden, indem lineDrop darauf aufgerufen wird. Nach dem Löschen eines Beratungsanrufs wechselt der ursprüngliche Anruf in der Regel wieder in den Zustand "Verbunden" . Wenn der Aufrufstatus des ursprünglichen Aufrufs onholdPendingTransfer lautet, kann die lineUnhold-Funktion verwendet werden, um den Aufruf wiederherzustellen. In diesem Fall ist der Anrufstatus des Konsultationsaufrufs auf "Leerlauf" festgelegt.

Die Anwendung kann auch Anrufe in einem einzigen Schritt übertragen, ohne sich mit dem dazwischen liegenden Beratungsgespräch befassen zu müssen, indem lineBlindTransfer verwendet wird.