Interface ICredentialProviderUserArray (credentialprovider.h)

Article
02/26/2024

Représente l’ensemble des utilisateurs qui apparaîtront dans l’interface utilisateur d’ouverture de session ou d’informations d’identification. Ces informations permettent au fournisseur d’informations d’identification d’énumérer l’ensemble pour récupérer des informations de propriété sur chaque utilisateur afin de remplir les champs ou de filtrer l’ensemble.

Héritage

L’interface ICredentialProviderUserArray hérite de l’interface IUnknown. ICredentialProviderUserArray a également les types de membres suivants :

Méthodes

L’interface ICredentialProviderUserArray a ces méthodes.


ICredentialProviderUserArray ::GetAccountOptions Récupère une valeur qui indique si la vignette « Autre utilisateur » pour les comptes locaux ou Microsoft s’affiche dans l’interface utilisateur d’ouverture de session ou d’informations d’identification.
ICredentialProviderUserArray ::GetAt Récupère un utilisateur spécifié à partir du tableau.
ICredentialProviderUserArray ::GetCount Récupère le nombre d’objets ICredentialProviderUser dans le tableau utilisateur.
ICredentialProviderUserArray ::SetProviderFilter Limite l’ensemble des utilisateurs dans le tableau aux comptes locaux ou aux comptes Microsoft.

Remarques

Cet objet est fourni par l’infrastructure du fournisseur d’informations d’identification Windows à votre fournisseur d’informations d’identification via la méthode ICredentialProviderSetUserArray ::SetUserArray . La propriété de cet objet reste dans l’infrastructure du fournisseur d’informations d’identification.

Quand implémenter

Les tiers n’implémentent pas cette interface. Une implémentation est incluse avec Windows.

Exemples

L’exemple suivant illustre un scénario qui utilise certaines des méthodes de cette interface. La pcpua variable représente un objet ICredentialProviderUserArray précédemment déclaré.


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();
        }
    }
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	credentialprovider.h

Voir aussi

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown

Partager via