Méthode ICredentialProviderFilter ::Filter (credentialprovider.h)

Article
08/22/2023

Évalue si une liste de fournisseurs d’informations d’identification doit être autorisée à fournir des vignettes d’informations d’identification.

Syntaxe

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

Paramètres

[in] cpus

Type : CREDENTIAL_PROVIDER_USAGE_SCENARIO

Pointeur vers une valeur CREDENTIAL_PROVIDER_USAGE_SCENARIO qui déclare les scénarios dans lesquels un fournisseur d’informations d’identification est pris en charge.

[in] dwFlags

Type : DWORD

Indicateurs de scénario d’utilisation. Ce paramètre est valide uniquement si les processeurs sont CPUS_CREDUI. Ils sont définis dans Wincred.h.

CREDUIWIN_GENERIC

Le nom d’utilisateur/mot de passe en texte brut est demandé.

CREDUIWIN_CHECKBOX

Cochez la case Enregistrer les informations d’identification .

CREDUIWIN_AUTHPACKAGE_ONLY

Seuls les fournisseurs d’informations d’identification qui prennent en charge le package d’authentification d’entrée doivent énumérer.

CREDUIWIN_IN_CRED_ONLY

Seules les informations d’identification entrantes pour le package d’authentification spécifique doivent être énumérées.

CREDUIWIN_ENUMERATE_ADMINS

Les fournisseurs d’informations d’identification doivent énumérer les administrateurs.

CREDUIWIN_ENUMERATE_CURRENT_USER

Seules les informations d’identification entrantes

CREDUIWIN_PACK_32_WOW

[in] rgclsidProviders

Type : GUID*

Pointeur vers un tableau de CLSID de fournisseur d’informations d’identification.

[in, out] rgbAllow

Type : BOOL*

Lors de l’entrée, pointeur vers un tableau de valeurs BOOL , une pour chaque membre correspondant du tableau rgclsidProviders , toutes initialisées à TRUE.

À la sortie, contient TRUE si le fournisseur d’informations d’identification correspondant dans rgclsidProviders est autorisé à fournir une vignette d’informations d’identification ; sinon, FALSE.

[in] cProviders

Type : DWORD

Nombre de membres dans rgbAllow ou rgclsidProviders (ils doivent être identiques).

Valeur retournée

Type : HRESULT

Retourne toujours S_OK.

Remarques

Lors de l’entrée, cette méthode reçoit deux tableaux parallèles ; rgclsidProviders, qui contient les CLSID du fournisseur d’informations d’identification et rgbAllow, qui contient des valeurs BOOL pour les CLSID correspondants. ICredentialProviderFilter ::Filter examine chaque fournisseur d’informations d’identification dans rgclsidProviders et détermine si le fournisseur d’informations d’identification doit être autorisé à énumérer les vignettes d’informations d’identification pour le scénario spécifié par dwFlags. Si cela est acceptable, l’entrée correspondante dans rgbAllow est définie sur TRUE. Si cela est inacceptable, il est défini sur FALSE.

Ne filtrez jamais un CLSID pour un fournisseur d’informations d’identification que vous ne connaissez pas.

Ne filtrez pas si les processeurs sont CPUS_CREDUI et si une valeur dwFlags de CREDUIWIN_GENERIC est passée.

Il est légitime de retourner la réussite de la méthode et de ne pas modifier rgbAllow.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	credentialprovider.h

Partager via