TSPI_lineCompleteTransfer-Funktion (tspi.h)
Die TSPI_lineCompleteTransfer-Funktion schließt die Übertragung des angegebenen Aufrufs an die im Konsultationsaufruf verbundene Partei ab. Wenn dwTransferMode LINETRANSFERMODE_CONFERENCE ist, wird das ursprüngliche Anrufhandle in eine Telefonkonferenz geändert. Andernfalls sollte der Dienstanbieter Anrufstatusmeldungen senden, die die Aufrufe in den Leerlauf ändern.
Syntax
LONG TSPIAPI TSPI_lineCompleteTransfer(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall,
HDRVCALL hdConsultCall,
HTAPICALL htConfCall,
LPHDRVCALL lphdConfCall,
DWORD dwTransferMode
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle des Dienstanbieters für den zu übertragenden Anruf. Der Anrufstatus von hdCall kann onHoldPendingTransfer sein.
hdConsultCall
Ein Handle für den Aufruf, der eine Verbindung mit dem Ziel der Übertragung darstellt. Der Anrufstatus von hdConsultCall kann verbunden, zurückgefahren, ausgelastet oder fortgesetzt werden.
htConfCall
Dieser Parameter ist nur gültig, wenn dwTransferMode als LINETRANSFERMODE_CONFERENCE angegeben wird. Der Dienstanbieter muss diesen Parameterwert speichern und in allen nachfolgenden Aufrufen der LINEEVENT-Prozedur verwenden, die Ereignisse für den Aufruf meldet. Andernfalls wird dieser Parameter ignoriert.
lphdConfCall
Ein Zeiger auf einen HDRVCALL , der den Bezeichner des Dienstanbieters für den Anruf darstellt. Dieser Parameter ist nur gültig, wenn dwTransferMode als LINETRANSFERMODE_CONFERENCE angegeben wird. Der Dienstanbieter muss diesen Speicherort mit seinem Handle für die neue Telefonkonferenz füllen, bevor er von dieser Funktion zurückkehrt.
dwTransferMode
Gibt an, wie die initiierte Übertragungsanforderung aufgelöst werden soll. Dieser Parameter verwendet eine der LINETRANSFERMODE_ Konstanten.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Diese Funktion schließt die Übertragung des ursprünglichen Anrufs , hdCall, an die Partei ab, die derzeit über hdConsultCall verbunden ist. Der Beratungsanruf wird in der Regel für den Beratungsanruf gewählt, der als Teil von TSPI_lineSetupTransfer zugewiesen ist, aber es kann sich um einen beliebigen Anruf sein, an den der Switch hdCall übertragen kann.
Die Übertragungsanforderung kann entweder als Übertragung oder als Drei-Wege-Telefonkonferenz aufgelöst werden. Wenn sie als Übertragung aufgelöst werden, sind die parteien, die über hdCall und hdConsultCall verbunden sind, miteinander verbunden, und sowohl hdCall als auch hdConsultCall wechseln in den Leerlaufzustand.
Wenn sie als Konferenz gelöst werden, treten alle drei Parteien in eine Telefonkonferenz ein. Beide vorhandenen Aufrufhandles bleiben gültig, wechseln jedoch in den Konferenzzustand . Ein Konferenzanrufhandle wird erstellt und zurückgegeben, und es wechselt in den verbundenen Zustand.
Es kann auch möglich sein, eine Blindübertragung eines Anrufs mit TSPI_lineBlindTransfer durchzuführen.
Diese Funktion unterscheidet sich von der entsprechenden TAPI-Funktion dadurch, dass sie dem TSPI-Modell für den Beginn der Lebensdauer eines Aufrufs folgt. TAPI und die Dienstanbieter-Exchange-Wechselhandles, die den Aufruf miteinander darstellen. Darüber hinaus ist es dem Dienstanbieter gestattet, Rückrufe für den neuen Aufruf auszuführen, bevor er von dieser Prozedur zurückgegeben wird. In jedem Fall muss der Dienstanbieter auch das zurückgegebene Handle als "noch nicht gültig" behandeln, bis die übereinstimmende ASYNC_COMPLETION Nachricht erfolgreich meldet. Mit anderen Worten, es darf keine LINEEVENT-Nachricht für den neuen Aufruf ausgeben oder in die Anrufanzahl in Nachrichten oder status Datenstrukturen für die Zeile einschließen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |