lineRemoveFromConference-Funktion (tapi.h)

Artikel
08/26/2023

Die lineRemoveFromConference-Funktion entfernt den angegebenen Anruf aus dem Konferenzanruf, zu dem er derzeit gehört. Die restlichen Anrufe in der Telefonkonferenz sind nicht betroffen.

Syntax

LONG lineRemoveFromConference(
  HCALL hCall
);

Parameter

hCall

Behandeln Sie den Aufruf, der aus der Konferenz entfernt werden soll. Die Anwendung muss besitzer dieses Aufrufs sein. Der Anrufstatus von hCall muss konferenziert sein.

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 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLSTATE, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL, LINEERR_NOTOWNER, LINEERR_UNINITIALIZED.

Hinweise

Durch diesen Vorgang wird eine Partei entfernt, die derzeit zu einer Telefonkonferenz gehört. Nachdem der Aufruf erfolgreich entfernt wurde, kann es möglich sein, ihn mithilfe des Handle weiter zu bearbeiten. Die Verfügbarkeit dieses Vorgangs und sein Ergebnis sind wahrscheinlich in vielen Implementierungen eingeschränkt. Beispielsweise kann in vielen Implementierungen nur die zuletzt hinzugefügte Partei aus einer Konferenz entfernt werden, und der entfernte Anruf kann automatisch gelöscht werden (wird im Leerlauf). Informieren Sie sich über die Gerätefunktionen der Leitung, um die verfügbaren Auswirkungen des Entfernens eines Anrufs von einer Konferenz zu ermitteln.

Wenn das Entfernen eines Teilnehmers aus einer Konferenz unterstützt wird, tritt der Teilnehmeranruf nach dem Entfernen aus der Konferenz in den Anrufstatus ein, der im DwRemoveFromConfState-Member in LINEADDRESSCAPS aufgeführt ist.