Antarmuka ICredentialProviderUserArray (credentialprovider.h)

Artikel
08/08/2024

Mewakili sekumpulan pengguna yang akan muncul di UI masuk atau kredensial. Informasi ini memungkinkan penyedia kredensial untuk menghitung set untuk mengambil informasi properti tentang setiap pengguna untuk mengisi bidang atau memfilter set.

Warisan

Antarmuka ICredentialProviderUserArray mewarisi dari antarmuka IUnknown . ICredentialProviderUserArray juga memiliki jenis anggota ini:

Metode

Antarmuka ICredentialProviderUserArray memiliki metode ini.


ICredentialProviderUserArray::GetAccountOptions Mengambil nilai yang menunjukkan apakah petak peta "Pengguna lain" untuk akun lokal atau Microsoft ditampilkan di UI masuk atau kredensial.
ICredentialProviderUserArray::GetAt Mengambil pengguna tertentu dari array.
ICredentialProviderUserArray::GetCount Mengambil jumlah objek ICredentialProviderUser dalam array pengguna.
ICredentialProviderUserArray::SetProviderFilter Membatasi kumpulan pengguna dalam array ke akun lokal atau akun Microsoft.

Keterangan

Objek ini disediakan oleh kerangka kerja penyedia info masuk Windows kepada penyedia kredensial Anda melalui metode ICredentialProviderSetUserArray::SetUserArray . Kepemilikan objek ini tetap dengan kerangka kerja penyedia kredensial.

Kapan harus menerapkan

Pihak ketiga tidak mengimplementasikan antarmuka ini. Implementasi disertakan dengan Windows.

Contoh

Contoh berikut menunjukkan skenario yang menggunakan beberapa metode antarmuka ini. Variabel pcpua mewakili objek ICredentialProviderUserArray yang dideklarasikan sebelumnya.


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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	credentialprovider.h

Lihat juga

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown

Bagikan melalui