Bagikan melalui

struktur CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR (credentialprovider.h)

  • Artikel

Menjelaskan satu bidang dalam kredensial. Misalnya, string atau gambar pengguna.

Sintaks

typedef struct _CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR {
  DWORD                          dwFieldID;
  CREDENTIAL_PROVIDER_FIELD_TYPE cpft;
  LPWSTR                         pszLabel;
  GUID                           guidFieldType;
} CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR;

Anggota

dwFieldID

Jenis: DWORD

ID unik bidang. Bidang harus memiliki pengidentifikasi unik dibandingkan dengan semua bidang lain pada penyedia kredensial tertentu. Ini berlaku terlepas dari apakah bidang ditampilkan atau disembunyikan.

cpft

Jenis: CREDENTIAL_PROVIDER_FIELD_TYPE

Jenis bidang.

pszLabel

Jenis: LPWSTR

Penunjuk ke buffer yang berisi nama bidang yang mudah diingat sebagai string Unicode yang dihentikan null. Ini digunakan untuk tujuan aksesibilitas dan antrean. Misalnya, beberapa bidang standar akan memiliki nama teman "Nama Pengguna", "Kata Sandi", dan "Masuk Ke".

guidFieldType

Jenis: GUID

GUID yang secara unik mengidentifikasi jenis bidang. Anggota ini memungkinkan Anda untuk membungkus fungsionalitas yang disediakan oleh penyedia kredensial yang ada di penyedia mereka sendiri. Penyedia kredensial pembungkusan tidak disarankan karena dapat menyebabkan perilaku tak terduga yang menonaktifkan penyedia kredensial dalam kotak.

Tabel berikut ini mencantumkan nilai guidFieldType yang didukung oleh Windows. Ini didefinisikan dalam Shlguid.h.

Nilai Makna
CPFG_LOGON_USERNAME
da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b
 Nama pengguna dimasukkan ke dalam kotak teks.
CPFG_LOGON_PASSWORD
60624cfa-a477-47b1-8a8e-3a4a19981827
 Kata sandi dimasukkan ke dalam kotak teks.
CPFG_SMARTCARD_USERNAME
3e1ecf69-568c-4d96-9d59-46444174e2d6
 Nama pengguna diperoleh dari kartu pintar yang dimasukkan.
CPFG_SMARTCARD_PIN
4fe5263b-9181-46c1-b0a4-9dedd4db7dea
 PIN yang diperoleh dari kartu pintar yang dimasukkan.
CPFG_CREDENTIAL_PROVIDER_LOGO
2d837775-f6cd-464e-a745-482fd0b47493
 Diperkenalkan di Windows 8: Gambar yang digunakan untuk mewakili penyedia kredensial di halaman masuk.
CPFG_CREDENTIAL_PROVIDER_LABEL
286BBFF3-BAD4-438F-B007-79B7267C3D48
 Diperkenalkan di Windows 8: Label yang terkait dengan penyedia kredensial di halaman masuk.

Keterangan

Setiap elemen UI yang disajikan kepada pengguna pada petak peta ditentukan oleh penyedia kredensial sebagai bidang. CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR adalah bagaimana penyedia kredensial mengidentifikasi bidang. Setelah bidang ditentukan untuk skenario penggunaan tertentu, bidang tidak dapat ditambahkan atau dikurangi. Penyedia kredensial perlu sepenuhnya menentukan semua bidang mereka sebelum menghitung petak peta. Jika bidang akan muncul atau menghilang sebagai bagian dari proses akuisisi kredensial, bidang tersebut masih belum ditentukan sebelumnya. Gunakan CREDENTIAL_PROVIDER_FIELD_STATE untuk menyembunyikan atau menampilkan bidang seperlunya.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header credentialprovider.h