Partager via


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

Voir aussi

ICredentialProvider

ICredentialProvider::UnAdvise