IAzPrincipalLocator
COMIDispatch (デュアル)comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。公式ドキュメント
Authorization Manager において ADAM プリンシパルを検索および選択します。
解説(Remarks)
IAzPrincipalLocator オブジェクトは、名前リゾルバーとオブジェクトピッカーを含むことができます。名前リゾルバーは、セキュリティ識別子 (SID) を表示名に変換します。オブジェクトピッカーは、ユーザーが ADAM プリンシパルの一覧から選択できるダイアログボックスを表示します。このダイアログボックスは、ユーザーが Authorization Manager のユーザーインターフェイスを通じてアプリケーショングループまたはロールを変更する際に表示されることがあります。
IAzPrincipalLocator インターフェイスは、次のキーの下に登録する必要があります。HKEY_LOCAL_MACHINE\Software\Microsoft\AzMan\ObjectPicker
このレジストリキーの下に、IAzPrincipalLocator インターフェイスの COM クラス ID を値とするサブキーを作成します。Authorization Manager は、登録されたプリンシパルロケーターを 1 つだけサポートします。メソッド 2
vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。
この IAzPrincipalLocator オブジェクトに関連付けられた IAzNameResolver インターフェイスへのポインターを取得します。
| ppNameResolver | IAzNameResolver** | out | SIDと名前を相互変換する名前解決オブジェクト(IAzNameResolver)を受け取るポインタである。 |
この IAzPrincipalLocator オブジェクトに関連付けられた IAzObjectPicker インターフェイスへのポインターを取得します。
| ppObjectPicker | IAzObjectPicker** | out | プリンシパルを選択するためのオブジェクトピッカー(IAzObjectPicker)を受け取るポインタである。 |
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_IAzPrincipalLocator "{E5C3507D-AD6A-4992-9C7F-74AB480B44CC}"
#usecom global IAzPrincipalLocator IID_IAzPrincipalLocator "{483AFB5D-70DF-4E16-ABDC-A1DE4D015A3E}"
#comfunc global IAzPrincipalLocator_get_NameResolver 7 sptr
#comfunc global IAzPrincipalLocator_get_ObjectPicker 8 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。