Freigeben über


ICredentialProviderEvents::CredentialsChanged-Methode (credentialprovider.h)

Signalisiert der Anmelde-Benutzeroberfläche oder der Anmeldeinformations-Benutzeroberfläche, dass die liste der Anmeldeinformationen geändert wurde. Dies geschieht, wenn sich die Anzahl der Anmeldeinformationen, die einzelnen Anmeldeinformationen ändern oder die Anzahl der verfügbaren Felder geändert wird. Dies ist eine asynchrone Methode.

Syntax

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

Parameter

[in] upAdviseContext

Typ: UINT_PTR

Ein Zeiger auf eine ganze Zahl, die eindeutig angibt, welcher Anmeldeinformationsanbieter eine erneute Enumeration angefordert hat. Der Anmeldeinformationsanbieter sollte den Schnittstellenzeiger, den er von Advise in diesem Parameter erhalten hat, zurückgeben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

In der Vergangenheit haben viele Anmeldeinformationsanbieter ICredentialProviderEvents::CredentialsChanged verwendet, um die Benutzeroberfläche zu aktualisieren. Dies funktioniert zwar, führt jedoch zu einer erneuten Enumeration aller Anmeldeinformationen des aufrufenden Anmeldeinformationsanbieters. Die Verarbeitung dieses Ereignisses kann unter bestimmten Umständen aufgrund dieser erneuten Enumeration zu Flashing- oder Fokusänderungen in der Benutzeroberfläche führen. Daher wird davon abgeraten, ICredentialProviderEvents::CredentialsChanged ausschließlich für Benutzeroberflächenupdates zu verwenden. Die neue Empfehlung lautet wie folgt:

  • Verwenden Sie ICredentialProviderEvents::CredentialsChanged nur, wenn ein Anmeldeinformationsanbieter eine automatische Anmeldung durchführen oder die Anzahl der Anmeldeinformationen ändern muss, die er aufzählt.
  • Verwenden Sie ICredentialProviderCredentialEvents2 , um die Anmelde- oder Anmeldeinformationsoberfläche eines Anmeldeinformationsanbieters zu aktualisieren.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile credentialprovider.h