Metodo ICredentialProvider::Advise (credentialprovider.h)
Consente a un provider di credenziali di avviare eventi nell'interfaccia utente di accesso o nell'interfaccia utente delle credenziali tramite un'interfaccia di callback.
Sintassi
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
Parametri
[in] pcpe
Tipo: ICredentialProviderEvents*
Puntatore a un'interfaccia di callback ICredentialProviderEvents da usare come meccanismo di notifica.
[in] upAdviseContext
Tipo: UINT_PTR
Puntatore a un intero che identifica in modo univoco il provider di credenziali che ha richiesto di rinumerare.
Valore restituito
Tipo: HRESULT
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Il metodo non deve essere implementato e deve restituire E_NOTIMPL se non lo fa. Potrebbe non esserci alcun motivo per chiamarlo, ad esempio se l'interfaccia utente di accesso o l'interfaccia utente delle credenziali non cambiano mai o aggiornano.
Questo metodo consente all'interfaccia utente di accesso e all'interfaccia utente delle credenziali di passare un puntatore ICredentialProviderEvents al provider di credenziali. Ciò consente al provider di credenziali di avere una comunicazione di callback asincrona con l'interfaccia utente accesso o credenziale. Ad esempio, un provider di smart card potrebbe voler enumerare di nuovo le credenziali quando viene inserita una nuova smart card. Per attivare nuovamente l'interfaccia utente di accesso per ottenere nuovamente le credenziali, il provider di credenziali deve chiamareCredentialChanged fornendo l'identificatore upAdviseContext .
I provider di credenziali che implementano questo metodo hanno la responsabilità di chiamare AddRefnell'oggetto ICredentialProviderEvents fornito. Questi provider di credenziali devono anche chiamare Release durante il metodo UnAdvise .
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | credentialprovider.h |