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

[アーティクル]
08/26/2023

HandoffDirect メソッドは、呼び出しを別のアプリケーションに渡します。これは、アプリケーションが呼び出しの所有権を必要としなくなったことを示します。

構文

HRESULT HandoffDirect(
  [in] BSTR pApplicationName
);

パラメーター

[in] pApplicationName

呼び出しを渡す特定のアプリケーション名を含む BSTR へのポインター。完全パス名または実行可能ファイル名を指定できます。

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
E_POINTER	pApplicationName パラメーターが有効なポインターではありません。

注釈

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

受信側のアプリケーションが、呼び出しに関連するメディアの種類の行を開いていなくても、ハンドオフは失敗します。 TAPI が通話の引き渡しに失敗した場合、TAPI は Disconnect を呼び出します。

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