Bagikan melalui


Antarmuka ICredentialProvider (credentialprovider.h)

Mengekspos metode yang digunakan dalam penyiapan dan manipulasi penyedia kredensial. Semua penyedia kredensial harus mengimplementasikan antarmuka ini.

Warisan

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

Metode

Antarmuka ICredentialProvider memiliki metode ini.

 
ICredentialProvider::Advise

Memungkinkan penyedia kredensial untuk memulai peristiwa di UI Masuk atau Antarmuka Pengguna kredensial melalui antarmuka panggilan balik.
ICredentialProvider::GetCredentialAt

Mendapatkan kredensial tertentu.
ICredentialProvider::GetCredentialCount

Mendapatkan jumlah kredensial yang tersedia di bawah penyedia kredensial ini.
ICredentialProvider::GetFieldDescriptorAt

Mendapatkan metadata yang menjelaskan bidang tertentu.
ICredentialProvider::GetFieldDescriptorCount

Mengambil jumlah bidang dalam yang diperlukan untuk menampilkan kredensial penyedia ini.
ICredentialProvider::SetSerialization

Mengatur karakteristik serialisasi penyedia kredensial.
ICredentialProvider::SetUsageScenario

Menentukan skenario di mana penyedia kredensial valid. Dipanggil setiap kali penyedia kredensial diinisialisasi.
ICredentialProvider::UnAdvise

Digunakan oleh UI Masuk atau Antarmuka Pengguna Kredensial untuk memberi tahu penyedia kredensial bahwa panggilan balik peristiwa tidak lagi diterima.

Keterangan

Antarmuka ini adalah cara Anda akan berinteraksi dengan UI Masuk dan UI Kredensial untuk aplikasi Anda.

Penyedia kredensial yang dibuat dipertahankan selama seluruh masa pakai UI Masuk. Karena itu, UI Masuk dapat mempertahankan status penyedia kredensial. Secara khusus, ia mengingat penyedia dan petak mana yang memberikan kredensial. Ini berarti Anda berpotensi menyimpan informasi status saat menggunakan CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_LOGON, CPUS_UNLOCK_WORKSTATION, dan CPUS_CHANGE_PASSWORD. Ini tidak terjadi pada antarmuka pengguna Kredensial. Antarmuka pengguna Kredensial membuat instans baru penyedia setiap kali aplikasi memanggil CredUIPromptForWindowsCredentials. Karena itu, UI Kredensial tidak dapat mengingat status penyedia kredensial.

Ketahuilah bahwa CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION yang dihasilkan dalam satu skenario mungkin disimpan dan digunakan dalam skenario penggunaan berikutnya. Karena itu, perlu untuk memastikan implementasi ICredentialProvider Anda cukup kuat untuk menangani skenario ini.

Windows 8 menambahkan fungsionalitas baru di API penyedia info masuk, terutama kemampuan untuk mengelompokkan kredensial menurut pengguna.

Persyaratan

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

Lihat juga

CREDENTIAL_PROVIDER_USAGE_SCENARIO

Pengalaman Masuk Windows yang digerakkan oleh Penyedia Kredensial

Penyedia Kredensial di Windows 10

ICredentialProviderCredential