ICredentialProvider::Advise, méthode (credentialprovider.h)
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.
Syntaxe
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
Paramètres
[in] pcpe
Type : ICredentialProviderEvents*
Pointeur vers une interface de rappel ICredentialProviderEvents à utiliser comme mécanisme de notification.
[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.
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La méthode n’a pas besoin d’être implémentée et doit retourner E_NOTIMPL si ce n’est pas le cas. Il n’y a peut-être aucune raison de l’appeler, par exemple si l’interface utilisateur d’ouverture de session ou d’informations d’identification ne change jamais ou ne le met jamais à jour.
Cette méthode permet à l’interface utilisateur d’ouverture de session et à l’interface utilisateur d’informations d’identification de passer un pointeur ICredentialProviderEvents au fournisseur d’informations d’identification. Cela permet au fournisseur d’informations d’identification d’avoir une communication de rappel asynchrone avec l’interface utilisateur d’ouverture de session ou d’informations d’identification. Par exemple, un fournisseur de carte intelligent peut vouloir énumérer à nouveau les informations d’identification lorsqu’une nouvelle carte intelligente est insérée. Pour déclencher l’interface utilisateur d’ouverture de session afin d’obtenir à nouveau les informations d’identification, le fournisseur d’informations d’identification doit appeler CredentialsChanged en fournissant l’identificateur upAdviseContext .
Les fournisseurs d’informations d’identification qui implémentent cette méthode ont la responsabilité d’appeler AddRef sur les ICredentialProviderEvents fournis. Ces fournisseurs d’informations d’identification doivent également appeler Release pendant la méthode UnAdvise .
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 |