Metode ICredentialProviderEvents::CredentialsChanged (credentialprovider.h)

Artikel
02/26/2024

Memberi sinyal UI Masuk atau Antarmuka Pengguna Kredensial bahwa daftar kredensial yang dijumlahkan telah berubah. Ini terjadi ketika jumlah kredensial berubah, kredensial individual berubah, atau jumlah bidang yang tersedia berubah. Ini adalah metode asinkron.

Sintaks

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

Parameter

[in] upAdviseContext

Jenis: UINT_PTR

Penunjuk ke bilangan bulat yang secara unik mengidentifikasi penyedia kredensial mana yang telah meminta enumerasi ulang. Penyedia kredensial harus meneruskan kembali pointer antarmuka yang diterimanya dari Advise dalam parameter ini.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Di masa lalu, banyak penyedia kredensial menggunakan ICredentialProviderEvents::CredentialsChanged untuk memperbarui UI. Meskipun ini berfungsi, ini menyebabkan enumerasi ulang semua kredensial dari penyedia kredensial panggilan. Pemrosesan peristiwa ini dapat, dalam beberapa keadaan, menyebabkan perubahan berkedip atau fokus di UI karena enumerasi ulang ini. Oleh karena itu, menggunakan ICredentialProviderEvents::CredentialsChanged hanya untuk pembaruan UI tidak disarankan. Rekomendasi baru adalah sebagai berikut:

Gunakan ICredentialProviderEvents::CredentialsChanged hanya jika penyedia kredensial perlu melakukan masuk otomatis atau mengubah jumlah kredensial yang dijumlahkannya.
Gunakan ICredentialProviderCredentialEvents2 untuk memperbarui UI Masuk atau Antarmuka Pengguna Kredensial penyedia info masuk.

Persyaratan

Persyaratan	Nilai
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

Bagikan melalui