ICredentialProvider-Schnittstelle (credentialprovider.h)
Macht Methoden verfügbar, die beim Einrichten und Bearbeiten eines Anmeldeinformationsanbieters verwendet werden. Alle Anmeldeinformationsanbieter müssen diese Schnittstelle implementieren.
Vererbung
Die ICredentialProvider-Schnittstelle erbt von der IUnknown-Schnittstelle . ICredentialProvider verfügt auch über die folgenden Typen von Membern:
Methoden
Die ICredentialProvider-Schnittstelle verfügt über diese Methoden.
| ICredentialProvider::Advise Ermöglicht einem Anmeldeinformationsanbieter das Initiieren von Ereignissen auf der Anmelde- oder Anmeldeinformationsoberfläche über eine Rückrufschnittstelle. |
| ICredentialProvider::GetCredentialAt Ruft bestimmte Anmeldeinformationen ab. |
| ICredentialProvider::GetCredentialCount Ruft die Anzahl der verfügbaren Anmeldeinformationen unter diesem Anmeldeinformationsanbieter ab. |
| ICredentialProvider::GetFieldDescriptorAt Ruft Metadaten ab, die ein angegebenes Feld beschreiben. |
| ICredentialProvider::GetFieldDescriptorCount Ruft die Anzahl der Felder ab, die zum Anzeigen der Anmeldeinformationen dieses Anbieters erforderlich sind. |
| ICredentialProvider::SetSerialization Legt die Serialisierungseigenschaften des Anmeldeinformationsanbieters fest. |
| ICredentialProvider::SetUsageScenario Definiert die Szenarien, für die der Anmeldeinformationsanbieter gültig ist. Wird immer dann aufgerufen, wenn der Anmeldeinformationsanbieter initialisiert wird. |
| ICredentialProvider::UnAdvise Wird von der Anmelde-Benutzeroberfläche oder der Benutzeroberfläche für Anmeldeinformationen verwendet, um den Anmeldeinformationsanbieter darüber zu informieren, dass Ereignisrückrufe nicht mehr akzeptiert werden. |
Hinweise
Auf dieser Schnittstelle interagieren Sie mit der Anmelde-Benutzeroberfläche und der Benutzeroberfläche für Anmeldeinformationen für Ihre App.
Ein instanziierter Anmeldeinformationsanbieter wird während der gesamten Lebensdauer einer Anmeldeoberfläche verwaltet. Aus diesem Fall kann die Anmeldeoberfläche den Status eines Anmeldeinformationsanbieters beibehalten. Insbesondere wird daran erinnert, welcher Anbieter und welche Kachel Anmeldeinformationen bereitgestellt haben. Dies bedeutet, dass Sie Möglicherweise Zustandsinformationen speichern können, wenn Sie eine CREDENTIAL_PROVIDER_USAGE_SCENARIO von CPUS_LOGON, CPUS_UNLOCK_WORKSTATION und CPUS_CHANGE_PASSWORD verwenden. Dies ist bei der Benutzeroberfläche für Anmeldeinformationen nicht der Fall. Die Benutzeroberfläche für Anmeldeinformationen erstellt jedes Mal, wenn eine Anwendung CredUIPromptForWindowsCredentials aufruft, eine neue instance des Anbieters. Aus diesem Fall kann sich die Benutzeroberfläche für Anmeldeinformationen nicht an den Status eines Anmeldeinformationsanbieters erinnern.
Beachten Sie, dass ein in einem Szenario generierter CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION gespeichert und in einem nachfolgenden Nutzungsszenario verwendet werden kann. Aus diesem Grund müssen Sie sicherstellen, dass Ihre ICredentialProvider-Implementierung robust genug ist, um dieses Szenario zu verarbeiten.
Windows 8 fügt neue Funktionen in der API für Anmeldeinformationsanbieter hinzu, in erster Linie die Möglichkeit, Anmeldeinformationen nach Benutzer zu gruppieren.
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
CREDENTIAL_PROVIDER_USAGE_SCENARIO
Vom Anmeldeinformationsanbieter gesteuerte Windows-Anmeldeumgebung