Partager via


Méthode ICredentialProviderEvents ::CredentialsChanged (credentialprovider.h)

Signale à l’interface utilisateur d’ouverture de session ou à l’interface utilisateur des informations d’identification que la liste énumérée des informations d’identification a changé. Cela se produit lorsque le nombre d’informations d’identification change, que les informations d’identification individuelles changent ou que le nombre de champs disponibles change. Il s’agit d’une méthode asynchrone.

Syntaxe

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

Paramètres

[in] upAdviseContext

Type : UINT_PTR

Pointeur vers un entier qui identifie de manière unique le fournisseur d’informations d’identification qui a demandé une nouvelle énumération. Le fournisseur d’informations d’identification doit renvoyer le pointeur d’interface qu’il a reçu de Advise dans ce paramètre.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Dans le passé, de nombreux fournisseurs d’informations d’identification utilisaient ICredentialProviderEvents ::CredentialsChanged pour mettre à jour l’interface utilisateur. Bien que cela fonctionne, cela entraîne une nouvelle énumération de toutes les informations d’identification du fournisseur d’informations d’identification appelant. Le traitement de cet événement peut, dans certaines circonstances, entraîner des changements de clignotant ou de focus dans l’interface utilisateur en raison de cette nouvelle énumération. Par conséquent, l’utilisation de ICredentialProviderEvents ::CredentialsChanged uniquement pour les mises à jour de l’interface utilisateur est déconseillée. La nouvelle recommandation est la suivante :

  • Utilisez ICredentialProviderEvents ::CredentialsChanged uniquement si un fournisseur d’informations d’identification doit effectuer une ouverture de session automatique ou modifier le nombre d’informations d’identification qu’il énumére.
  • Utilisez ICredentialProviderCredentialEvents2 pour mettre à jour l’interface utilisateur d’ouverture de session ou l’interface utilisateur des informations d’identification d’un fournisseur d’informations d’identification.

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