TSPI_linePrepareAddToConference-Funktion (tspi.h)
Die TSPI_linePrepareAddToConference-Funktion bereitet eine vorhandene Telefonkonferenz für das Hinzufügen einer anderen Partei vor. Es entsteht eine neue, temporäre Konsultation. Die neue Telefonkonferenz kann anschließend der Telefonkonferenz hinzugefügt werden.
Syntax
LONG TSPIAPI TSPI_linePrepareAddToConference(
DRV_REQUESTID dwRequestID,
HDRVCALL hdConfCall,
HTAPICALL htConsultCall,
LPHDRVCALL lphdConsultCall,
LPLINECALLPARAMS const lpCallParams
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdConfCall
Der Handle für eine Telefonkonferenz. Der Anrufstatus von hdConfCall kann verbunden werden.
htConsultCall
Die TAPI übernimmt den neuen, temporären Konsultationsaufruf. Der Dienstanbieter muss dies speichern und in allen nachfolgenden Aufrufen der LINEEVENT-Prozedur verwenden, die Ereignisse für den neuen Aufruf meldet. Der Anrufstatus von hdAddCall ist nicht zutreffend.
lphdConsultCall
Ein Zeiger auf einen HDRVCALL , der den Bezeichner des Dienstanbieters für den neuen, temporären Konsultationsaufruf darstellt. Der Dienstanbieter muss diesen Speicherort mit seinem Handle für den neuen Aufruf füllen, bevor diese Prozedur zurückgegeben wird. Dieses Handle ist ungültig, wenn die Funktion zu einem Fehler führt.
lpCallParams
Ein Zeiger auf eine LINECALLPARAMS-Instanz , die Aufrufparameter enthält, die beim Einrichten des Konsultationsaufrufs verwendet werden sollen. Dieser Parameter wird auf NULL festgelegt, wenn keine speziellen Aufrufsetupparameter gewünscht sind.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter des 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_BEARERMODEUNAVAIL, LINEERR_INVALLINESTATE, LINEERR_CALLUNAVAIL, LINEERR_INVALMEDIAMODE, LINEERR_CONFERENCEFULL, LINEERR_INVALRATE, LINEERR_INUSE, LINEERR_NOMEM, LINEERR_INVALADDRESSMODE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALBEARERMODE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLPARAMS, LINEERR_RATEUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALCONFCALLHANDLE, LINEERR_USERUSERINFOTOOBIG.
Hinweise
Der Dienstanbieter gibt LINEERR_INVALLINESTATE zurück, wenn sich die Zeile derzeit nicht in einem Zustand befindet, in dem dieser Vorgang ausgeführt werden kann. Der Dienstanbieter muss eine Liste der aktuell gültigen Vorgänge im dwLineFeatures-Member (vom Typ LINEFEATURE) in der LINEDEVSTATUS-Struktur angeben.
Der Dienstanbieter gibt LINEERR_INVALCALLSTATE zurück, wenn sich die Telefonkonferenz nicht in einem gültigen Zustand für den angeforderten Vorgang befindet.
Diese Funktion platziert eine vorhandene Telefonkonferenz im Zustand onHoldPendingConference und erstellt einen Konsultationsaufruf, der später der vorhandenen Telefonkonferenz mit TSPI_lineAddToConference hinzugefügt werden kann.
Der Konsultationsaufruf kann mit TSPI_lineDrop abgebrochen werden. Es kann auch möglich sein, dass TAPI zwischen der Konsultationsanruf und der abgehaltenen Telefonkonferenz mit TSPI_lineSwapHold. Der Dienstanbieter führt zunächst die Medienüberwachung für den neuen Aufruf für mindestens die Medientypen durch, die in der Leitung überwacht wurden.
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-Nachrichten 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 |