ホーム › Devices.Tapi › ITDirectoryObjectUser

ITDirectoryObjectUser

COMIDispatch (デュアル)

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IID34621d6f-6cff-11d1-aff7-00c04fc31fee継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

公式ドキュメント

ITDirectoryObjectUser インターフェイスは、User オブジェクトがサポートする共通のインターフェイスです。このインターフェイスは、ITDirectoryObject に対して QueryInterface を呼び出すことで作成されます。

メソッド 2

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_IPPhonePrimary(LPWSTR* ppName)

get_IPPhonePrimary メソッドは、ユーザーのプライマリ IP フォンであるコンピューターの名前を取得します。

ppName

LPWSTR*

out

ユーザーの IP プライマリフォンの BSTR 表現へのポインター。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	無効なポインターです。

解説(Remarks)

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

vtbl 8 HRESULT put_IPPhonePrimary(LPWSTR pName)

put_IPPhonePrimary メソッドは、ユーザーのプライマリ IP フォンとしてマシンの名前を設定します。

pName

LPWSTR

ユーザーの IP プライマリフォンの BSTR 表現へのポインター。

戻り値

このメソッドは、次のいずれかの値を返すことがあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	無効なポインターです。

解説(Remarks)

このメソッドは、後でディレクトリに追加される新しいオブジェクトに対してのみ使用できます。アプリケーションが既存の User オブジェクトの IP フォンを変更したい場合は、古い IP フォンが何であるかを判断するために、サーバーからオブジェクトを列挙する必要があります。これは、TAPI 3 アプリケーションが 1 台以上の他のマシンで実行されていることを意味します。ローカルマシン上のアプリケーションには、それらの他のアプリケーションがまだ実行されているかどうかの情報がありません。したがって、既存の User オブジェクトの IP フォンを変更することは、アプリケーションの役割ではありません。

既存のユーザーの IP フォンを変更するには、そのユーザーを削除して再追加する必要があります。

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

この関数は、暗号化されていない形式でデータをネットワーク上に送信する場合があります。そのため、ネットワークを盗聴している者がデータを読み取れる可能性があります。このメソッドを使用する前に、データを平文で送信することのセキュリティリスクを考慮する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。

出力引数:

#define global IID_ITDirectoryObjectUser "{34621D6F-6CFF-11D1-AFF7-00C04FC31FEE}"
#usecom global ITDirectoryObjectUser IID_ITDirectoryObjectUser "{}"
#comfunc global ITDirectoryObjectUser_get_IPPhonePrimary  7 var
#comfunc global ITDirectoryObjectUser_put_IPPhonePrimary  8 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_ITDirectoryObjectUser "{34621D6F-6CFF-11D1-AFF7-00C04FC31FEE}"
#usecom global ITDirectoryObjectUser IID_ITDirectoryObjectUser "{}"
#comfunc global ITDirectoryObjectUser_get_IPPhonePrimary  7 sptr
#comfunc global ITDirectoryObjectUser_put_IPPhonePrimary  8 wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。