Interface ICredentialProviderCredential2 (credentialprovider.h)

Étend l’interface ICredentialProviderCredential en ajoutant une méthode qui récupère l’identificateur de sécurité (SID) d’un utilisateur. Les informations d’identification sont associées à cet utilisateur et peuvent être regroupées sous la vignette de l’utilisateur.

Héritage

L’interface ICredentialProviderCredential2 hérite de ICredentialProviderCredential. ICredentialProviderCredential2 a également les types de membres suivants :

Méthodes

L’interface ICredentialProviderCredential2 possède ces méthodes.

ICredentialProviderCredential2::GetUserSid Récupère l’identificateur de sécurité (SID) de l’utilisateur associé à ces informations d’identification.

Remarques

Cette classe est requise pour créer un fournisseur d’informations d’identification V2. Les fournisseurs d’informations d’identification V2 fournissent une expérience de connexion personnalisée pour l’utilisateur. Cela se produit par le fournisseur d’informations d’identification indiquant à l’interface utilisateur de connexion quelles options de connexion sont disponibles pour un utilisateur. Il est recommandé que les nouveaux fournisseurs d’informations d’identification soient des fournisseurs d’informations d’identification V2.

Pour créer un instance ICredentialProviderCredential2, un SID valide doit être retourné par la fonction GetUserSid. Valide est défini par le SID retourné pour l’un des utilisateurs actuellement énumérés par l’interface utilisateur d’ouverture de session.

L’objet ICredentialProviderUserArray est un outil utile pour obtenir les utilisateurs disponibles et déterminer ceux auxquels vous souhaitez associer. Cet objet contient une liste d’objets ICredentialProviderUser qui peuvent être interrogés pour obtenir des informations sur les utilisateurs qui seront énumérés. Par exemple, vous pouvez obtenir le SID ou le nom d’utilisateur de l’utilisateur à l’aide de GetStringValue avec un paramètre transmis de PKEY_Identity_PrimarySid ou PKEY_Identity_USerName respectivement. Vous pouvez même filtrer les résultats à l’aide de SetProviderFilter pour afficher uniquement un sous-ensemble d’utilisateurs disponibles.

L’utilisation de ICredentialProviderUserArray est facultative, mais il s’agit d’un moyen pratique d’obtenir les informations nécessaires pour créer des valeurs SID valides. Pour obtenir la liste des utilisateurs qui seront énumérés par l’interface utilisateur d’ouverture de session, implémentez l’interface ICredentialProviderSetUserArray pour obtenir l’objet ICredentialProviderUserArray à partir de SetUserArray. L’interface utilisateur de connexion appelle SetUserArray avant GetCredentialCount, de sorte que l’objet ICredentialProviderUserArray est prêt lorsqu’un fournisseur d’informations d’identification est sur le point de retourner des informations d’identification.

Un fournisseur d’informations d’identification V2 est représenté par une icône affichée sous le lien « Options de connexion ». Pour fournir une icône pour votre fournisseur d’informations d’identification, définissez une CREDENTIAL_PROVIDER_FIELD_TYPE de CPFT_TILE_IMAGE dans les informations d’identification proprement dites. Vérifiez ensuite que le guidFieldType du CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR est défini sur CPFG_CREDENTIAL_PROVIDER_LOGO. La taille recommandée pour une icône est de 72 x 72 pixels.

Comme pour spécifier une icône pour votre fournisseur d’informations d’identification, vous pouvez également spécifier une chaîne de texte pour identifier votre fournisseur d’informations d’identification. Cette chaîne s’affiche dans une fenêtre contextuelle lorsqu’un utilisateur pointe sur l’icône. Pour ce faire, définissez une CREDENTIAL_PROVIDER_FIELD_TYPE de CPFT_SMALL_TEXT dans les informations d’identification proprement dites. Vérifiez ensuite que le guidFieldType du CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR est défini sur CPFG_CREDENTIAL_PROVIDER_LABEL. Cette chaîne doit compléter l’icône du fournisseur d’informations d’identification décrite ci-dessus et être suffisamment descriptive pour que les utilisateurs comprennent ce qu’il s’agit. Par exemple, la description du fournisseur de mot de passe image est « Mot de passe image ».

Quand implémenter

Implémentez cette interface pour associer des vignettes d’informations d’identification à des vignettes utilisateur spécifiques dans l’interface utilisateur d’ouverture de session.

Configuration requise

Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	credentialprovider.h

Voir aussi

Fournisseurs d’informations d’identification dans Windows 10

ICredentialProviderCredential

ICredentialProviderCredentialEvents2