ITAddress::Forward メソッド (tapi3if.h)
Forward メソッドは、 ITForwardInformation に含まれる転送手順に従って、アドレス宛ての呼び出しを転送します。 pForwardInfo が NULL に設定されている場合、転送は取り消されます。
構文
HRESULT Forward(
[in] ITForwardInformation *pForwardInfo,
[in] ITBasicCallControl *pCall
);
パラメーター
[in] pForwardInfo
ITForwardInformation インターフェイスへのポインター。転送を取り消すには NULL に設定します。
[in] pCall
テレフォニー環境で必要な場合は、コンサルテーション呼び出し用の ITBasicCallControl インターフェイスへのポインター。 必要でない場合は NULL を 指定できます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
アドレスが転送をサポートしていないか、 pCall が有効な呼び出しを指していません。 |
|
操作を実行するためのメモリが不足しています。 |
|
pForwardInfo パラメーターまたは pCall パラメーターが有効なポインターではありません。 |
|
TAPI 3 DLL によってタイムアウトしたため、操作が失敗しました。タイムアウト間隔は 2 分です。 |
|
この TAPI 2.1 関数から返されるエラー コードについては、「 LineForward 」を参照してください。 |
解説
pForwardInfo の情報は、以前の転送手順をオーバーライドします。
ITAddress::p ut_DoNotDisturb が fDoNotDisturb をVARIANT_FALSEに設定して呼び出されると、すべての転送が取り消されます。
アプリケーションは、ITAddressCapabilities::get_AddressCapability (AC_ADDRESSCAPFLAGS、plCapability) を呼び出し、LINEADDRCAPFLAGS_定数のメンバーであるフラグ LINEADDRCAPFLAGS_FWDCONSULTが plCapability で設定されているかどうかを確認することで、NULL 以外のコンサルテーション呼び出しが必要かどうかを判断できます。 設定されている場合は、Forward メソッドの pCall パラメーターに NULL 以外の値が必要です。
Forward メソッドの一部は、TAPI 2.1 LineForward 関数の COM ラッパーです。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | tapi3if.h (Tapi3.h を含む) |
| Library | Uuid.lib |
| [DLL] | Tapi3.dll |
関連項目
ITAddress::CreateForwardInfoObject