ITBasicCallControl::BlindTransfer-Methode (tapi3if.h)

Artikel
03/02/2024

Die BlindTransfer-Methode führt eine blinde oder einstufige Übertragung des angegebenen Aufrufs an die angegebene Zieladresse durch. Die Anwendung muss der Besitzer des Aufrufs sein. Nach einer erfolgreichen Übertragung wechselt der Aufrufzustand zu CS_DISCONNECTED.

Syntax

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

Parameter

[in] pDestAddress

Zeiger auf BSTR , der die Zieladresse für die Übertragung enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_POINTER	Die pDestAddress ist kein gültiger Zeiger.
E_FAIL	Blindübertragung wird nicht unterstützt.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
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.

Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pDestAddress-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.

In einigen Fällen muss die Anwendung möglicherweise die Adressübersetzungsschnittstellen ( ITAddressTranslation und ITAddressTranslationInfo) verwenden, um eine pDestAddress-Zeichenfolge im richtigen Format abzurufen.