ICredentialProviderSetUserArray
COM公式ドキュメント
資格情報プロバイダーが、ログオン UI または資格情報 UI に表示されるユーザーのセットを受け取るためのメソッドを提供します。
解説(Remarks)
実装するタイミング
ログオン UI または資格情報 UI にどのユーザーが表示されるかを知る必要がある資格情報プロバイダーの場合に、このインターフェイスを実装します。使用するタイミング
このインターフェイスは Windows の資格情報プロバイダー フレームワークによってのみ使用されます。このメソッドを他の関係者が呼び出すべきではありません。メソッド 1
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
vtbl 3 HRESULT SetUserArray(ICredentialProviderUserArray* users)
ログオン UI または資格情報 UI の初期化中に、その UI に表示するユーザーのセットを取得するためにシステムによって呼び出されます。
| users | ICredentialProviderUserArray* | in | ICredentialProviderUser オブジェクトのセットを含む配列オブジェクトへのポインター。各オブジェクトは、ログオン UI または資格情報 UI に表示されるユーザーを表します。この配列により、資格情報プロバイダーは各ユーザー オブジェクトを列挙し、その SID、関連付けられた資格情報プロバイダーの ID、さまざまな形式のユーザー名、およびログオン状態文字列を照会できます。 |
戻り値
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラー コードを返します。
解説(Remarks)
このメソッドは、資格情報プロバイダー フレームワークから ICredentialProviderUserArray の所有権を移転しないことに注意してください。このメソッドが提供する情報は変更できません。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ICredentialProviderSetUserArray "{095C1484-1C0C-4388-9C6D-500E61BF84BD}"
#usecom global ICredentialProviderSetUserArray IID_ICredentialProviderSetUserArray "{}"
#comfunc global ICredentialProviderSetUserArray_SetUserArray 3 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。