ICredentialProvider::Advise-Methode (credentialprovider.h)

  • Artikel

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

Weitere Informationen

ICredentialProvider

ICredentialProvider::UnAdvise