lineCompleteTransfer-Funktion (tapi.h)

Artikel
08/26/2023

Die lineCompleteTransfer-Funktion schließt die Übertragung des angegebenen Aufrufs an die im Konsultationsaufruf verbundene Partei ab.

Syntax

LONG lineCompleteTransfer(
  HCALL   hCall,
  HCALL   hConsultCall,
  LPHCALL lphConfCall,
  DWORD   dwTransferMode
);

Parameter

hCall

Handle an den zu übertragenden Anruf. Die Anwendung muss ein Besitzer dieses Aufrufs sein. Der Aufrufstatus von hCall muss onHold oder onHoldPendingTransfer sein.

hConsultCall

Handle für den Aufruf, der eine Verbindung mit dem Ziel der Übertragung darstellt. Die Anwendung muss ein Besitzer dieses Aufrufs sein. Der Aufrufstatus von hConsultCall muss verbunden, zurückgerufen, ausgelastet oder fortgesetzt sein.

lphConfCall

Zeiger auf einen Speicherort, an dem ein hCall-Handle zurückgegeben werden kann. Wenn dwTransferMode LINETRANSFERMODE_CONFERENCE ist, wird die neu erstellte Telefonkonferenz in lphConfCall zurückgegeben, und die Anwendung wird alleiniger Besitzer der Telefonkonferenz. Andernfalls wird dieser Parameter von TAPI ignoriert.

dwTransferMode

Wie die initiierte Übertragungsanforderung aufgelöst werden soll. Dieser Parameter verwendet eine der LINETRANSFERMODE_ Konstanten.

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_NOTOWNER, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCONSULTCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALTRANSFERMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Hinweise

Die LINE_REPLY Nachricht, die als Reaktion auf einen Aufruf der lineCompleteTransfer-Funktion gesendet wird, basiert auf der status des Aufrufs, der durch den hCall-Parameter angegeben wird.

Dieser Vorgang schließt die Übertragung des ursprünglichen Anrufs hCall an die Partei ab, die derzeit durch hConsultCall verbunden ist. Der Beratungsanruf wird in der Regel über den Im Rahmen von lineSetupTransfer zugeordneten Beratungsanruf gewählt, aber es kann sich um einen beliebigen Anruf handelt, an den der Switch hCall übertragen kann.

Die Übertragungsanforderung kann entweder als Übertragung oder als Drei-Wege-Telefonkonferenz aufgelöst werden. Wenn sie als Übertragung aufgelöst werden, werden die durch hCall und hConsultCall verbundenen Parteien miteinander verbunden, und sowohl hCall als auch hConsultCall werden in der Regel aus der Zeile der Anwendung gelöscht und in den Leerlaufzustand übergehen. Das Aufrufhandle der Anwendung bleibt nach Abschluss der Übertragung gültig. Die Anwendung muss die Zuordnung ihres Handles mit lineDeallocateCall aufheben, wenn sie nicht mehr an dem übertragenen Anruf interessiert ist.

Wenn sie als Konferenz beschlossen werden, treten alle drei Parteien in eine Telefonkonferenz ein. Beide vorhandenen Anrufhandles bleiben gültig, wechseln jedoch in den Konferenzzustand. Ein Telefonkonferenzhandle wird erstellt und zurückgegeben, und es wechselt in den Zustand "Verbunden" .

Wenn lineGetConfRelatedCalls unmittelbar nach lineCompleteTransfer aufgerufen wird, mit dem Ergebnis, dass die Anrufe konferenzfähig sind, gibt lineGetConfRelatedCalls möglicherweise keine vollständige Liste verwandter Anrufe zurück. Dies liegt daran, dass TAPI wartet, um eine LINE_CALLSTATE Nachricht zu erhalten, die angibt, dass der Anruf LINECALLSTATE_CONFERENCED eingegangen ist, bevor der Anruf als Tatsächlicher Teil der Konferenz betrachtet wird. Das heißt, es wartet, bis der Dienstanbieter den Konferenzstatus bestätigt. Nachdem die Anwendung die LINE_CALLSTATE-Nachricht erhalten hat, gibt lineGetConfRelatedCalls vollständige Informationen zurück.

Es kann auch möglich sein, eine Blindübertragung eines Anrufs mit lineBlindTransfer durchzuführen.