TSPI_lineRemoveFromConference-Funktion (tspi.h)
Die funktion TSPI_lineRemoveFromConference entfernt den angegebenen Anruf aus der Telefonkonferenz, zu der er derzeit gehört. Die verbleibenden Anrufe in der Telefonkonferenz sind nicht betroffen.
Syntax
LONG TSPIAPI TSPI_lineRemoveFromConference(
DRV_REQUESTID dwRequestID,
HDRVCALL hdCall
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdCall
Das Handle für den Anruf, der aus der Konferenz entfernt werden soll. Der Anrufstatus von hdCall kann konferenzt werden.
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_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Durch diesen Vorgang wird eine Partei entfernt, die derzeit zu einer Telefonkonferenz gehört. Nachdem der Aufruf erfolgreich entfernt wurde, kann er mithilfe des Handles weiter bearbeitet werden. Die Verfügbarkeit dieses Vorgangs und dessen Ergebnis sind in vielen Implementierungen wahrscheinlich eingeschränkt. In vielen Implementierungen kann beispielsweise nur die zuletzt hinzugefügte Partei aus einer Konferenz entfernt werden, und der entfernte Anruf wird möglicherweise automatisch gelöscht (wird im Leerlauf). Der Dienstanbieter gibt seine Funktionen in LINEDEVCAPS in Bezug auf die verfügbaren Auswirkungen des Entfernens eines Anrufs aus einer Konferenz an.
Wenn das Entfernen eines Teilnehmers von einer Konferenz unterstützt wird, muss der Dienstanbieter im dwRemoveFromConfState-Member in LINEADDRESSCAPS den Anrufzustand angeben, in den der Anruf übergehen soll, nachdem er aus der Konferenz entfernt wurde.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |