ICredentialProviderFilter::Filter メソッド (credentialprovider.h)

[アーティクル]
02/26/2024

資格情報プロバイダーの一覧で資格情報タイルの提供を許可するかどうかを評価します。

構文

HRESULT Filter(
  [in]      CREDENTIAL_PROVIDER_USAGE_SCENARIO cpus,
  [in]      DWORD                              dwFlags,
  [in]      GUID                               *rgclsidProviders,
  [in, out] BOOL                               *rgbAllow,
  [in]      DWORD                              cProviders
);

パラメーター

[in] cpus

種類: CREDENTIAL_PROVIDER_USAGE_SCENARIO

資格情報プロバイダーがサポートされているシナリオを宣言する CREDENTIAL_PROVIDER_USAGE_SCENARIO 値へのポインター。

[in] dwFlags

型: DWORD

使用シナリオフラグ。このパラメーターは、 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

[in] rgclsidProviders

型: GUID*

資格情報プロバイダー CLSID の配列へのポインター。

[in, out] rgbAllow

種類: BOOL*

エントリでは、 BOOL 値の配列へのポインター。 rgclsidProviders 配列の対応するメンバーごとに 1 つ、すべて TRUE に初期化されます。

終了時に、rgclsidProviders の対応する資格情報プロバイダーが資格情報タイルを提供できる場合は TRUE が含まれます。それ以外の場合は FALSE。

[in] cProviders

型: DWORD

rgbAllow または rgclsidProviders のメンバーの数 (同じである必要があります)。

戻り値

型: HRESULT

常に S_OK を返します。

解説

入力時に、このメソッドは 2 つの並列配列を受け取ります。 rgclsidProviders。資格情報プロバイダー CLSID と rgbAllow が含まれます。このプロバイダーには、対応する CLSID の BOOL 値が含まれます。 ICredentialProviderFilter::Filter は rgclsidProviders 内の各資格情報プロバイダーを調べ、 dwFlags で指定されたシナリオの資格情報タイルを列挙するために資格情報プロバイダーを許可するかどうかを決定します。これが許容される場合は、 rgbAllow 内の対応するエントリが TRUE に設定されます。これが許容できない場合は、FALSE に設定 されます。

知らない資格情報プロバイダーの CLSID を除外しないでください。

cpus がCPUS_CREDUIされ、CREDUIWIN_GENERICの dwFlags 値が渡された場合はフィルター処理しないでください。

rgbAllow を変更せず、メソッドから成功を返すのが正当です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	credentialprovider.h

次の方法で共有