ITBasicCallControl::P arkIndirect メソッド (tapi3if.h)

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

ParkIndirect メソッドは、呼び出しをパークし、パークされたアドレスを返します。

構文

HRESULT ParkIndirect(
  [out] BSTR *ppNonDirAddress
);

パラメーター

[out] ppNonDirAddress

呼び出しがパークされたアドレスの BSTR 表現へのポインター。

戻り値

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

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

注釈

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

ParkDirect を使用すると、呼び出しをパークするアドレスがアプリケーションによって決定されます。無向パークでは、スイッチによってアドレスが決定され、アプリケーションに提供されます。どちらの場合も、このアドレスを指定することで、パークされた呼び出しを解除できます。

パークされた呼び出しは、正常にパークされた後、切断された状態に入ります。

一部のスイッチでは、通話が長時間パークされた後にユーザーに通知できます。アプリケーションでは、通話の理由がアラームに設定されたオファリング通話が表示されます。

アプリケーションは SysFreeString を使用して、 ppNonDirAddress パラメーターに割り当てられたメモリを解放する必要があります。