ITBasicCallControl::Conference-Methode (tapi3if.h)

Artikel
08/26/2023

Die Conference-Methode fügt der Konferenz, an der der aktuelle Aufruf teilnimmt, einen Konsultationsaufruf hinzu. Wenn ein zugeordnetes ITCallHub-Objekt nicht vorhanden ist, wird es erstellt.

Syntax

HRESULT Conference(
  [in] ITBasicCallControl *pCall,
  [in] VARIANT_BOOL       fSync
);

Parameter

[in] pCall

Zeiger auf die SCHNITTSTELLE "ITBasicCallControl " für den Konsultationsaufruf.

[in] fSync

Gibt an, ob der Anruf synchron (VARIANT_TRUE) oder asynchron (VARIANT_FALSE) durchgeführt werden soll. Weitere Erläuterungen finden Sie unter Verbinden .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
E_POINTER	Der pCall-Parameter ist kein gültiger Zeiger.
E_INVALIDARG	Der pCall-Parameter verweist nicht auf eine gültige Schnittstelle.
TAPI_E_TIMEOUT	Der Vorgang ist fehlgeschlagen, da die TAPI 3-DLL ein Timeout aufweist. Das Timeoutintervall beträgt zwei Minuten.

Hinweise

Einige Dienstanbieter unterstützen diesen Vorgang nicht, während das Streaming aktiv ist. Die Anwendung muss möglicherweise ITStream::StopStream oder ITSubStream::StopSubStream vor dem Vorgang und ITStream::StartStream oder ITSubStream::StartSubStream nach Abschluss des Vorgangs aufrufen.

Der Konsultationsaufruf (pCall) wird von ITAddress::CreateCall erstellt. Die Verbindung wird durch Aufrufen der Finish-Methode abgeschlossen. Ein Beispiel für die Verwendung dieser Methode finden Sie unter Erstellen einer einfachen Konferenz .

Wenn sich der Konsultationsaufruf nicht im CONNECTED-Zustand befindet, wenn Konferenz aufgerufen wird, verwendet TAPI die Zieladresse (wie beim ersten Erstellen des Konsultationsaufrufs über ITAddress::CreateCall angegeben) und versucht zu diesem Zeitpunkt, eine Verbindung herzustellen. Wenn der ursprüngliche Anruf eine NULL-Zieladresse hatte, schlägt Conference mit E_INVALIDARG fehl.