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

Weitere Informationen

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown