Interfaccia ICredentialProviderUserArray (credentialprovider.h)

Articolo
08/22/2023

Rappresenta il set di utenti che verranno visualizzati nell'interfaccia utente di accesso o credenziale. Queste informazioni consentono al provider di credenziali di enumerare il set per recuperare le informazioni sulle proprietà relative a ogni utente per popolare i campi o filtrare il set.

Ereditarietà

L'interfaccia ICredentialProviderUserArray eredita dall'interfaccia IUnknown . ICredentialProviderUserArray include anche questi tipi di membri:

Metodi

L'interfaccia ICredentialProviderUserArray dispone di questi metodi.


ICredentialProviderUserArray::GetAccountOptions Recupera un valore che indica se il riquadro "Altro utente" per gli account locali o Microsoft viene visualizzato nell'interfaccia utente di accesso o credenziali.
ICredentialProviderUserArray::GetAt Recupera un utente specificato dalla matrice.
ICredentialProviderUserArray::GetCount Recupera il numero di oggetti ICredentialProviderUser nella matrice utente.
ICredentialProviderUserArray::SetProviderFilter Limita il set di utenti nella matrice a account locali o account Microsoft.

Commenti

Questo oggetto viene fornito dal framework del provider di credenziali di Windows al provider di credenziali tramite il metodo ICredentialProviderSetUserArray::SetUserArray . La proprietà di questo oggetto rimane con il framework del provider di credenziali.

Quando implementare

Le terze parti non implementano questa interfaccia. Un'implementazione è inclusa in Windows.

Esempio

Nell'esempio seguente viene illustrato uno scenario che usa alcuni dei metodi di questa interfaccia. La pcpua variabile rappresenta un oggetto ICredentialProviderUserArray dichiarato in precedenza.


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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	credentialprovider.h

Vedi anche

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown

Condividi tramite