ICredentialProviderFilter
COM公式ドキュメント
実行時に利用可能な情報に基づいて、資格情報プロバイダーを動的にフィルターするために使用します。
解説(Remarks)
サードパーティの資格情報プロバイダーが、このインターフェイスを使用してデスクトップ上のシステム資格情報プロバイダーをフィルターまたは無効化することは推奨されません。企業がサードパーティの資格情報プロバイダーを配置し、現在利用可能なシステム資格情報プロバイダーを無効化したい場合、それはドメイン管理者が慎重に検討したうえで下すべき判断です。管理者が資格情報プロバイダーをフィルターできるシステムポリシーが存在するため、サードパーティの資格情報プロバイダーに直接フィルターを組み込むのではなく、それらを使用すべきです。
メソッド 2
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
資格情報プロバイダーの一覧が資格情報タイルの提供を許可されるべきかどうかを評価します。
| cpus | CREDENTIAL_PROVIDER_USAGE_SCENARIO | in | 資格情報プロバイダーがサポートされるシナリオを宣言する CREDENTIAL_PROVIDER_USAGE_SCENARIO 値へのポインター。 |
| dwFlags | DWORD | in | 使用シナリオフラグ。このパラメーターは cpus が CPUS_CREDUI の場合にのみ有効です。これらは Wincred.h で定義されています。 CREDUIWIN_GENERICプレーンテキストのユーザー名とパスワードが要求されています。 CREDUIWIN_CHECKBOX資格情報の保存チェックボックスを表示します。 CREDUIWIN_AUTHPACKAGE_ONLY入力認証パッケージをサポートする資格情報プロバイダーのみが列挙されるべきです。 CREDUIWIN_IN_CRED_ONLY特定の認証パッケージに対する受信資格情報のみが列挙されるべきです。 CREDUIWIN_ENUMERATE_ADMINS資格情報プロバイダーは管理者を列挙すべきです。 CREDUIWIN_ENUMERATE_CURRENT_USER受信資格情報のみ CREDUIWIN_PACK_32_WOW |
| rgclsidProviders | GUID* | in | 資格情報プロバイダーの CLSID の配列へのポインター。 |
| rgbAllow | BOOL* | inout | 入力時には、rgclsidProviders 配列の各対応メンバーに 1 つずつ対応する BOOL 値の配列へのポインターであり、すべて TRUE に初期化されています。 出力時には、rgclsidProviders 内の対応する資格情報プロバイダーが資格情報タイルの提供を許可される場合は TRUE を、そうでない場合は FALSE を格納します。 |
| cProviders | DWORD | in | rgbAllow または rgclsidProviders のメンバー数(両者は同じであるべきです)。 |
戻り値
型: HRESULT
常に S_OK を返します。
解説(Remarks)
入力時に、このメソッドは 2 つの並列配列を受け取ります。rgclsidProviders は資格情報プロバイダーの CLSID を格納し、rgbAllow は対応する CLSID に対する BOOL 値を格納します。ICredentialProviderFilter::Filter は rgclsidProviders 内の各資格情報プロバイダーを調べ、その資格情報プロバイダーが dwFlags で指定されたシナリオに対して資格情報タイルを列挙することを許可されるべきかどうかを判断します。許可可能であれば、rgbAllow 内の対応するエントリを TRUE に設定します。許可できない場合は FALSE に設定します。
自分が把握していない資格情報プロバイダーの CLSID を決してフィルターしないでください。
cpus が CPUS_CREDUI で、dwFlags 値として CREDUIWIN_GENERIC が渡された場合はフィルターしないでください。
メソッドから成功を返し、rgbAllow を変更しないことも正当な動作です。
リモートセッションから資格情報を更新します。
| pcpcsIn | CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION* | in | CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 構造体への定数ポインター。 |
| pcpcsOut | CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION* | out | CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 構造体へのポインター。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_ICredentialProviderFilter "{A5DA53F9-D475-4080-A120-910C4A739880}" #usecom global ICredentialProviderFilter IID_ICredentialProviderFilter "{}" #comfunc global ICredentialProviderFilter_Filter 3 int,int,var,var,int #comfunc global ICredentialProviderFilter_UpdateRemoteCredential 4 var,var ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。#define global IID_ICredentialProviderFilter "{A5DA53F9-D475-4080-A120-910C4A739880}" #usecom global ICredentialProviderFilter IID_ICredentialProviderFilter "{}" #comfunc global ICredentialProviderFilter_Filter 3 int,int,sptr,sptr,int #comfunc global ICredentialProviderFilter_UpdateRemoteCredential 4 sptr,sptr ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。