ICredentialProviderCredential2-Schnittstelle (credentialprovider.h)
Erweitert die ICredentialProviderCredential-Schnittstelle , indem eine Methode hinzugefügt wird, die die Sicherheits-ID (SID) eines Benutzers abruft. Die Anmeldeinformationen sind diesem Benutzer zugeordnet und können unter der Kachel des Benutzers gruppiert werden.
Vererbung
Die ICredentialProviderCredential2-Schnittstelle erbt von ICredentialProviderCredential. ICredentialProviderCredential2 verfügt auch über folgende Membertypen:
Methoden
Die ICredentialProviderCredential2-Schnittstelle verfügt über diese Methoden.
| ICredentialProviderCredential2::GetUserSid Ruft die Sicherheits-ID (SID) des Benutzers ab, der diesen Anmeldeinformationen zugeordnet ist. |
Hinweise
Diese Klasse ist zum Erstellen eines V2-Anmeldeinformationsanbieters erforderlich. V2-Anmeldeinformationsanbieter bieten eine personalisierte Anmeldeerfahrung für den Benutzer. Dies geschieht, indem der Anmeldeinformationsanbieter der Anmeldeoberfläche mitteilt, welche Anmeldeoptionen für einen Benutzer verfügbar sind. Es wird empfohlen, dass neue Anmeldeinformationsanbieter V2-Anmeldeinformationsanbieter sein sollten.
Um eine ICredentialProviderCredential2-instance zu erstellen, muss eine gültige SID von der GetUserSid-Funktion zurückgegeben werden. Gültig wird durch die zurückgegebene SID definiert, die für einen der Benutzer gilt, die derzeit von der Anmeldeoberfläche aufgezählt werden.
Ein nützliches Tool zum Abrufen der verfügbaren Benutzer und bestimmen, mit welchen Benutzern Sie zuordnen möchten, ist das ICredentialProviderUserArray-Objekt . Dieses Objekt enthält eine Liste von ICredentialProviderUser-Objekten , die abgefragt werden können, um Informationen zu den Benutzern zu erhalten, die aufgelistet werden. Beispielsweise können Sie die SID oder den Benutzernamen des Benutzers mithilfe von GetStringValue mit einem übergebenen Parameter von PKEY_Identity_PrimarySid bzw. PKEY_Identity_USerName abrufen. Sie können die Ergebnisse sogar mithilfe von SetProviderFilter filtern, um nur eine Teilmenge der verfügbaren Benutzer anzuzeigen.
Die Verwendung von ICredentialProviderUserArray ist optional, aber es ist eine bequeme Möglichkeit, die erforderlichen Informationen zu erhalten, um gültige SID-Werte zu erstellen. Um eine Liste von Benutzern abzurufen, die von der Anmeldebenutzeroberfläche aufgelistet werden, implementieren Sie die ICredentialProviderSetUserArray-Schnittstelle , um das ICredentialProviderUserArray-Objekt aus SetUserArray abzurufen. Die Anmeldebenutzeroberfläche ruft SetUserArray vor GetCredentialCount auf, damit das ICredentialProviderUserArray-Objekt bereit ist, wenn ein Anmeldeinformationsanbieter Anmeldeinformationen zurückgibt.
Ein V2-Anmeldeinformationsanbieter wird durch ein Symbol dargestellt, das unter dem Link "Anmeldeoptionen" angezeigt wird. Um ein Symbol für Ihren Anmeldeinformationsanbieter bereitzustellen, definieren Sie eine CREDENTIAL_PROVIDER_FIELD_TYPE von CPFT_TILE_IMAGE in den Anmeldeinformationen selbst. Stellen Sie dann sicher, dass guidFieldType des CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR auf CPFG_CREDENTIAL_PROVIDER_LOGO festgelegt ist. Die empfohlene Größe für ein Symbol beträgt 72 x 72 Pixel.
Ähnlich wie bei der Angabe eines Symbols für Ihren Anmeldeinformationsanbieter können Sie auch eine Textzeichenfolge angeben, um Ihren Anmeldeinformationsanbieter zu identifizieren. Diese Zeichenfolge wird in einem Popupfenster angezeigt, wenn ein Benutzer über das Symbol bewegt wird. Definieren Sie hierzu eine CREDENTIAL_PROVIDER_FIELD_TYPE von CPFT_SMALL_TEXT in den Anmeldeinformationen selbst. Stellen Sie dann sicher, dass guidFieldType des CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR auf CPFG_CREDENTIAL_PROVIDER_LABEL festgelegt ist. Diese Zeichenfolge sollte das oben beschriebene Symbol des Anmeldeinformationsanbieters ergänzen und beschreibend genug sein, damit Benutzer verstehen, was es ist. Beispielsweise lautet die Beschreibung des Bildkennwortanbieters "Bildkennwort".
Wann sollte implementiert werden?
Implementieren Sie diese Schnittstelle, um Kacheln für Anmeldeinformationen bestimmten Benutzerkacheln auf der Anmeldeoberfläche zuzuordnen.Anforderungen
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | credentialprovider.h |