Antarmuka ICredentialProviderCredential2 (credentialprovider.h)
Memperluas antarmuka ICredentialProviderCredential dengan menambahkan metode yang mengambil pengidentifikasi keamanan (SID) pengguna. Info masuk dikaitkan dengan pengguna tersebut dan dapat dikelompokkan di bawah petak peta pengguna.
Warisan
Antarmuka ICredentialProviderCredential2 mewarisi dari ICredentialProviderCredential. ICredentialProviderCredential2 juga memiliki jenis anggota ini:
Metode
Antarmuka ICredentialProviderCredential2 memiliki metode ini.
| ICredentialProviderCredential2::GetUserSid Mengambil pengidentifikasi keamanan (SID) pengguna yang terkait dengan kredensial ini. |
Keterangan
Kelas ini diperlukan untuk membuat penyedia kredensial V2. Penyedia kredensial V2 memberikan pengalaman masuk yang dipersonalisasi untuk pengguna. Ini terjadi oleh penyedia kredensial yang memberi tahu UI Masuk opsi masuk apa yang tersedia untuk pengguna. Disarankan agar penyedia kredensial baru harus penyedia kredensial V2.
Untuk membuat instans ICredentialProviderCredential2 , SID yang valid perlu dikembalikan oleh fungsi GetUserSid . Valid ditentukan oleh SID yang dikembalikan untuk salah satu pengguna yang saat ini dijumlahkan oleh UI Masuk.
Alat yang berguna untuk mendapatkan pengguna yang tersedia dan menentukan mana yang ingin Anda kaitkan adalah objek ICredentialProviderUserArray . Objek ini berisi daftar objek ICredentialProviderUser yang dapat dikueri untuk mendapatkan informasi tentang pengguna yang akan dijumlahkan. Misalnya Anda dapat memperoleh SID atau nama pengguna pengguna menggunakan GetStringValue dengan parameter yang diteruskan masing-masing PKEY_Identity_PrimarySid atau PKEY_Identity_USerName . Anda bahkan dapat memfilter hasil menggunakan SetProviderFilter untuk hanya menampilkan subset pengguna yang tersedia.
Menggunakan ICredentialProviderUserArray bersifat opsional, tetapi ini adalah cara mudah untuk mendapatkan informasi yang diperlukan untuk membuat nilai SID yang valid. Untuk mendapatkan daftar pengguna yang akan dijumlahkan oleh UI Masuk, terapkan antarmuka ICredentialProviderSetUserArray untuk mendapatkan objek ICredentialProviderUserArray dari SetUserArray. UI masuk memanggil SetUserArray sebelum GetCredentialCount, sehingga objek ICredentialProviderUserArray siap ketika penyedia kredensial akan mengembalikan kredensial.
Penyedia kredensial V2 diwakili oleh ikon yang ditampilkan di bawah tautan "Opsi masuk". Untuk menyediakan ikon untuk penyedia kredensial Anda, tentukan CREDENTIAL_PROVIDER_FIELD_TYPECPFT_TILE_IMAGE dalam kredensial itu sendiri. Kemudian pastikan guidFieldTypedari CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR diatur ke CPFG_CREDENTIAL_PROVIDER_LOGO. Ukuran yang disarankan untuk ikon adalah 72 kali 72 piksel.
Mirip dengan menentukan ikon untuk penyedia kredensial, Anda juga dapat menentukan string teks untuk mengidentifikasi penyedia kredensial Anda. String ini muncul di jendela pop-up saat pengguna mengarahkan mouse ke atas ikon. Untuk melakukan ini, tentukan CREDENTIAL_PROVIDER_FIELD_TYPECPFT_SMALL_TEXT dalam kredensial itu sendiri. Kemudian pastikan guidFieldTypedari CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR diatur ke CPFG_CREDENTIAL_PROVIDER_LABEL. String ini harus melengkapi ikon penyedia kredensial yang dijelaskan di atas dan cukup deskriptif sehingga pengguna memahami apa itu. Misalnya, deskripsi penyedia kata sandi gambar adalah "Kata Sandi Gambar".
Kapan harus menerapkan
Terapkan antarmuka ini untuk mengaitkan petak kredensial dengan ubin pengguna tertentu di UI Masuk.Persyaratan
| Klien minimum yang didukung | Windows 8 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | credentialprovider.h |