ITMedia::p ut_MediaTitle メソッド

[ ランデブー IP テレフォニー会議のコントロールとインターフェイスは、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティングシステムでは使用できません。 RTC クライアント API も同様の機能を提供します。

put_MediaTitle メソッドは、アプリケーションが情報または表示目的で使用できるメディアのテキストタイトルを設定します。文字セットが ASCII の場合、これは ASCII 変換可能な文字列である必要があります。それ以外の場合は、 任意の BSTR 文字列を指定できます。

構文

HRESULT put_MediaTitle(
  [in] BSTR pMediaTitle
);

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	pMediaTitle パラメーターは有効なポインターではありません。
E_INVALIDARG	pMediaTitle パラメーターが無効です。
E_OUTOFMEMORY	操作を実行するためのメモリが不足しています。
E_FAIL	未定義のエラーが発生しました。
E_NOTIMPL	このメソッドはまだ実装されていません。

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

この関数は、暗号化されていない形式でネットワーク経由でデータを送信する場合があります。そのため、ネットワーク上で傍受しているユーザーがデータを読み取ることができる可能性があります。この方法を使用する前に、クリアテキストでデータを送信するセキュリティリスクを考慮する必要があります。