Interface ICredentialProvider (credentialprovider.h)
Expose les méthodes utilisées dans la configuration et la manipulation d’un fournisseur d’informations d’identification. Tous les fournisseurs d’informations d’identification doivent implémenter cette interface.
Héritage
L’interface ICredentialProvider hérite de l’interface IUnknown. ICredentialProvider a également les types de membres suivants :
Méthodes
L’interface ICredentialProvider a ces méthodes.
| ICredentialProvider::Advise Permet à un fournisseur d’informations d’identification de lancer des événements dans l’interface utilisateur d’ouverture de session ou l’interface utilisateur des informations d’identification via une interface de rappel. |
| ICredentialProvider::GetCredentialAt Obtient des informations d’identification spécifiques. |
| ICredentialProvider::GetCredentialCount Obtient le nombre d’informations d’identification disponibles sous ce fournisseur d’informations d’identification. |
| ICredentialProvider::GetFieldDescriptorAt Obtient des métadonnées qui décrivent un champ spécifié. |
| ICredentialProvider::GetFieldDescriptorCount Récupère le nombre de champs dans le nécessaire pour afficher les informations d’identification de ce fournisseur. |
| ICredentialProvider::SetSerialization Définit les caractéristiques de sérialisation du fournisseur d’informations d’identification. |
| ICredentialProvider::SetUsageScenario Définit les scénarios pour lesquels le fournisseur d’informations d’identification est valide. Appelé chaque fois que le fournisseur d’informations d’identification est initialisé. |
| ICredentialProvider::UnAdvise Utilisé par l’interface utilisateur d’ouverture de session ou l’interface utilisateur des informations d’identification pour informer le fournisseur d’informations d’identification que les rappels d’événements ne sont plus acceptés. |
Remarques
Cette interface vous permet d’interagir avec l’interface utilisateur d’ouverture de session et l’interface utilisateur des informations d’identification de votre application.
Un fournisseur d’informations d’identification instancié est conservé pendant toute la durée de vie d’une interface utilisateur d’ouverture de session. Pour cette raison, l’interface utilisateur d’ouverture de session peut conserver l’état d’un fournisseur d’informations d’identification. En particulier, il mémorise le fournisseur et la vignette qui ont fourni des informations d’identification. Cela signifie que vous pouvez potentiellement stocker des informations d’état lorsque vous utilisez une CREDENTIAL_PROVIDER_USAGE_SCENARIO de CPUS_LOGON, CPUS_UNLOCK_WORKSTATION et CPUS_CHANGE_PASSWORD. Ce n’est pas le cas avec l’interface utilisateur des informations d’identification. L’interface utilisateur des informations d’identification crée une nouvelle instance du fournisseur chaque fois qu’une application appelle CredUIPromptForWindowsCredentials. Pour cette raison, l’interface utilisateur des informations d’identification ne peut pas mémoriser l’état d’un fournisseur d’informations d’identification.
N’oubliez pas qu’un CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION généré dans un scénario peut être enregistré et utilisé dans un scénario d’utilisation ultérieur. Pour cette raison, il est nécessaire de vérifier que votre implémentation ICredentialProvider est suffisamment robuste pour gérer ce scénario.
Windows 8 ajoute de nouvelles fonctionnalités à l’API des fournisseurs d’informations d’identification, principalement la possibilité de regrouper les informations d’identification par utilisateur.
Configuration requise
| 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 |
Voir aussi
CREDENTIAL_PROVIDER_USAGE_SCENARIO
Expérience de connexion Windows pilotée par un fournisseur d’informations d’identification
Fournisseurs d’informations d’identification dans Windows 10