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

Anmeldeinformationsanbieter in Windows 10

ICredentialProviderCredential