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

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

BlindTransfer メソッドは、指定した宛先アドレスへの指定された呼び出しのブラインドまたはシングルステップ転送を実行します。アプリケーションは、呼び出しの所有者である必要があります。転送が成功すると、呼び出し状態は CS_DISCONNECTED に遷移します。

構文

HRESULT BlindTransfer(
  [in] BSTR pDestAddress
);

パラメーター

[in] pDestAddress

転送の宛先アドレスを含む BSTR へのポインター。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	pDestAddress は有効なポインターではありません。
E_FAIL	ブラインド転送はサポートされていません。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
TAPI_E_TIMEOUT	TAPI 3 DLL によってタイムアウトしたため、操作に失敗しました。タイムアウト間隔は 2 分です。

注釈

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

アプリケーションでは、SysAllocString を使用して pDestAddress パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。

場合によっては、アプリケーションでアドレス変換インターフェイス (ITAddressTranslation と ITAddressTranslationInfo) を使用して、適切な形式の pDestAddress 文字列を取得することが必要になる場合があります。