ICredentialProviderUserArray-Schnittstelle (credentialprovider.h)
Stellt die Gruppe von Benutzern dar, die auf der Anmelde- oder Anmeldeinformationsoberfläche angezeigt werden. Diese Informationen ermöglichen es dem Anmeldeinformationsanbieter, den Satz aufzulisten, um Eigenschafteninformationen zu jedem Benutzer abzurufen, um Felder aufzufüllen oder den Satz zu filtern.
Vererbung
Die ICredentialProviderUserArray-Schnittstelle erbt von der IUnknown-Schnittstelle . ICredentialProviderUserArray verfügt auch über folgende Membertypen:
Methoden
Die ICredentialProviderUserArray-Schnittstelle verfügt über diese Methoden.
ICredentialProviderUserArray::GetAccountOptions Ruft einen Wert ab, der angibt, ob die Kachel "Anderer Benutzer" für lokale Oder Microsoft-Konten auf der Anmelde- oder Anmeldeinformationsoberfläche angezeigt wird. |
ICredentialProviderUserArray::GetAt Ruft einen angegebenen Benutzer aus dem Array ab. |
ICredentialProviderUserArray::GetCount Ruft die Anzahl der ICredentialProviderUser-Objekte im Benutzerarray ab. |
ICredentialProviderUserArray::SetProviderFilter Schränkt die Gruppe der Benutzer im Array auf lokale Konten oder Microsoft-Konten ein. |
Hinweise
Dieses Objekt wird vom Windows-Anbieterframework für Anmeldeinformationen für Ihren Anmeldeinformationsanbieter über die ICredentialProviderSetUserArray::SetUserArray-Methode bereitgestellt. Der Besitz dieses Objekts verbleibt beim Framework des Anmeldeinformationsanbieters.
Wann muss implementiert werden?
Drittanbieter implementieren diese Schnittstelle nicht. Eine Implementierung ist in Windows enthalten.Beispiele
Im folgenden Beispiel wird ein Szenario veranschaulicht, in dem einige der Methoden dieser Schnittstelle verwendet werden. Die pcpua
Variable stellt ein zuvor deklariertes ICredentialProviderUserArray-Objekt dar.
DWORD dwCount = 0;
HRESULT hr = pcpua->GetCount(&dwCount);
if (SUCCEEDED(hr))
{
for (DWORD i = 0; i < dwCount; i++)
{
ICredentialProviderUser *pcpu = NULL;
hr = pcpua->GetAt(i, &pcpu);
if (SUCCEEDED(hr))
{
PWSTR pszName = NULL;
hr = pcpu->GetStringValue(PKEY_Identity_UserName, &pszName);
if (SUCCEEDED(hr))
{
// Do something with the string
CoTaskMemFree(pszName);
}
pcpu->Release();
}
}
}
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | credentialprovider.h |