ITBasicCallControl::Transfer-Methode (tapi3if.h)

Artikel
03/04/2024

Die Transfer-Methode überträgt den aktuellen Aufruf an die Zieladresse.

Syntax

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

Parameter

[in] pCall

Zeiger auf itBasicCallControl-Schnittstelle des Konsultationsaufrufs, der für die Übertragung erstellt wurde.

[in] fSync

Gibt an, ob die Methode synchron (VARIANT_TRUE) oder asynchron (VARIANT_FALSE) abgeschlossen werden soll.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert	Bedeutung
S_OK	Methode war erfolgreich.
E_INVALIDARG	Der pCall-Parameter verweist nicht auf einen gültigen Aufruf.
E_FAIL	Übertragungen werden nicht unterstützt.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.
TAPI_E_TIMEOUT	Der Vorgang ist fehlgeschlagen, weil für die TAPI 3-DLL ein Timeout aufgetreten ist. 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.

Die Anrufüberweisung umfasst die Einrichtung eines Beratungsgesprächs zur Vorbereitung der Überweisung. pCall ist der ITBasicCallControl-Zeiger , der von ITAddress::CreateCall nach der Erstellung eines Konsultationsaufrufs zurückgegeben wird. ITBasicCallControl::Finish (FM_ASTRANSFER) schließt die Übertragung ab.

Wenn sich der Konsultationsaufruf beim Aufruf der Übertragung nicht im CONNECTED-Zustand befindet, verwendet TAPI die Zieladresse (wie angegeben, als der Konsultationsaufruf zum ersten Mal über ITAddress::CreateCall erstellt wurde) und versucht, eine Verbindung zu diesem Zeitpunkt herzustellen. Wenn der ursprüngliche Aufruf eine NULL-Zieladresse hatte, schlägt die Übertragung mit E_INVALIDARG fehl.