ITDirectoryObjectUser::p ut_IPPhonePrimary メソッド (rend.h)
[ランデブー IP テレフォニー会議のコントロールとインターフェイスは、Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティング システムでは使用できません。 RTC クライアント API も同様の機能を提供します。
put_IPPhonePrimaryメソッドは、コンピューターの名前をユーザーのプライマリ IP 電話として設定します。
構文
HRESULT put_IPPhonePrimary(
[in] BSTR pName
);
パラメーター
[in] pName
ユーザーの IP プライマリフォンの BSTR 表現へのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
ポインターが無効です。 |
注釈
このメソッドは、その後ディレクトリに追加される新しいオブジェクトでのみ使用できます。 アプリケーションが既存のユーザー オブジェクトの IP Phone を変更する場合は、サーバーからオブジェクトを列挙して、古い IP フォンを特定する必要があります。 これは、TAPI 3 アプリケーションが 1 つ以上の他のマシンで実行されていることを意味します。 ローカル コンピューター上のアプリケーションには、それらの他のアプリケーションがまだ実行されているかどうかに関する情報がありません。 そのため、既存のユーザー オブジェクトで IP Phone を変更するのはアプリケーションの場所ではありません。
既存のユーザーの IP Phone を変更するには、ユーザーを削除して再追加する必要があります。
アプリケーションでは 、SysAllocString を使用して pName パラメーターのメモリを割り当て、変数が不要になったときに SysFreeString を使用してメモリを解放する必要があります。
この関数は、暗号化されていない形式でネットワーク経由でデータを送信する場合があります。そのため、ネットワーク上で傍受しているユーザーがデータを読み取ることができる可能性があります。 このメソッドを使用する前に、クリア テキストでデータを送信するセキュリティ リスクを考慮する必要があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | rend.h |
| [DLL] | Rend.dll |