ICredentialProvider::Advise-Methode (credentialprovider.h)
Ermöglicht einem Anmeldeinformationsanbieter das Initiieren von Ereignissen auf der Anmelde- oder Anmeldeinformationsoberfläche über eine Rückrufschnittstelle.
Syntax
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
Parameter
[in] pcpe
Typ: ICredentialProviderEvents*
Ein Zeiger auf eine ICredentialProviderEvents-Rückrufschnittstelle , die als Benachrichtigungsmechanismus verwendet werden soll.
[in] upAdviseContext
Typ: UINT_PTR
Ein Zeiger auf eine ganze Zahl, die eindeutig identifiziert, welcher Anmeldeinformationsanbieter eine erneute Enumeration angefordert hat.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die Methode muss nicht implementiert werden und sollte E_NOTIMPL zurückgeben, falls dies nicht der Fall ist. Es gibt möglicherweise keinen Grund, sie aufzurufen, z. B. wenn sich die Anmeldeoberfläche oder die Anmeldeinformationsoberfläche nie ändert oder aktualisiert.
Mit dieser Methode können die Anmeldeschnittstelle und die Benutzeroberfläche für Anmeldeinformationen einen ICredentialProviderEvents-Zeiger an den Anmeldeinformationsanbieter übergeben. Dadurch kann der Anmeldeinformationsanbieter eine asynchrone Rückrufkommunikation mit der Anmelde- oder Anmeldeinformationsoberfläche durchführen. Ein Anbieter für intelligente Karte kann beispielsweise Anmeldeinformationen erneut auflisten, wenn ein neuer intelligenter Karte eingefügt wird. Um die Anmeldebenutzeroberfläche zum erneuten Abrufen von Anmeldeinformationen auszulösen, sollte der Anmeldeinformationsanbieter CredentialsChanged aufrufen und den upAdviseContext-Bezeichner bereitstellen.
Anmeldeinformationsanbieter, die diese Methode implementieren, sind dafür verantwortlich , AddRef für die bereitgestellten ICredentialProviderEvents aufzurufen. Diese Anmeldeinformationsanbieter müssen auch Release während der UnAdvise-Methode aufrufen.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | credentialprovider.h |