ITBasicCallControl::Transfer メソッド (tapi3if.h)

[アーティクル]
03/02/2024

Transfer メソッドは、現在の呼び出しを宛先アドレスに転送します。

構文

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

パラメーター

[in] pCall

転送用に作成されたコンサルテーション呼び出しの ITBasicCallControl インターフェイスへのポインター。

[in] fSync

メソッドを同期 (VARIANT_TRUE) または非同期 (VARIANT_FALSE) で完了する必要があるかどうかを示します。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	意味
S_OK	メソッドが成功しました。
E_INVALIDARG	pCall パラメーターは、有効な呼び出しを指していません。
E_FAIL	転送はサポートされていません。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
TAPI_E_TIMEOUT	TAPI 3 DLL によってタイムアウトしたため、操作に失敗しました。タイムアウト間隔は 2 分です。

注釈

ストリーミングがアクティブな間、一部のサービスプロバイダーはこの操作をサポートしていません。アプリケーションでは、操作の前に ITStream::StopStream または ITSubStream::StopSubStream を呼び出し、操作の完了後に ITStream::StartStream または ITSubStream::StartSubStream を呼び出す必要がある場合があります。

通話転送には、転送の準備として相談呼び出しを設定する必要があります。 pCall は、コンサルティング呼び出しの作成後に ITAddress::CreateCall によって返される ITBasicCallControl ポインターです。 ITBasicCallControl::Finish (FM_ASTRANSFER) は転送を完了します。

転送が呼び出されたときにコンサルテーション通話が CONNECTED 状態でない場合、TAPI は宛先アドレス (ITAddress::CreateCall を使用して最初に作成されたときに指定) を使用し、その時点で接続を試みます。元の呼び出しに NULL 宛先アドレスがある場合、転送はE_INVALIDARGで失敗します。