ICredentialProvider::GetCredentialCount method (credentialprovider.h)

Artikel
02/26/2024

Mendapatkan jumlah kredensial yang tersedia di bawah penyedia kredensial ini.

Sintaks

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Parameter

[out] pdwCount

Jenis: DWORD*

Penunjuk ke nilai DWORD yang menerima jumlah kredensial.

[out] pdwDefault

Jenis: DWORD*

Penunjuk ke nilai DWORD yang menerima indeks kredensial yang akan digunakan sebagai default. Jika tidak ada nilai default yang ditetapkan, nilai ini harus diatur ke CREDENTIAL_PROVIDER_NO_DEFAULT.

[out] pbAutoLogonWithDefault

Jenis: BOOL*

Penunjuk ke nilai BOOL yang menunjukkan apakah kredensial default yang diidentifikasi oleh pdwDefault harus digunakan untuk upaya masuk otomatis. Upaya masuk otomatis berarti UI Masuk atau Antarmuka Pengguna Kredensial akan segera memanggil GetSerialization pada petak peta default penyedia.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini diperlukan.

Saat UI Masuk atau Antarmuka Pengguna Kredensial siap untuk interaksi pengguna, kredensial default dipilih secara default. Karena setiap penyedia kredensial menyediakan kredensial default, aturan berikut menentukan apakah pdwDefault akan menerima fokus atau apakah kredensial akan masuk secara otomatis.

Jika kredensial default telah ditentukan, kredensial tersebut tidak dimaksudkan untuk digunakan untuk masuk otomatis, dan pdwDefault digunakan untuk masuk otomatis, maka pdwDefault akan digunakan sebagai default.
Jika pdwDefault berasal dari penyedia yang terakhir masuk dan belum ada default dengan masuk otomatis, maka pdwDefault akan digunakan sebagai default.
Jika tidak ada default yang ditentukan, maka pdwDefault akan digunakan sebagai default.

Jika jumlah kredensial yang valid berubah, penyedia kredensial harus memanggil CredentialsChanged pada instans ICredentialProviderEvents yang disediakan di Advise.

Praktik Terbaik Penyedia Kredensial

Penyedia info masuk menangani rahasia pengguna yang sangat sensitif untuk menyelesaikan permintaan masuk dan membuka kunci. Sebagai praktik terbaik, informasi rahasia seperti kata sandi dan VPN harus ditangani dengan sangat hati-hati. Teknik yang tepat untuk menangani informasi rahasia dalam penyedia kredensial adalah:

Selalu buang rahasia dengan aman. Untuk melakukan ini, panggil SecureZeroMemory sebelum membebaskan memori yang digunakan untuk menyimpan rahasia apa pun.
Buang rahasia dengan aman segera setelah digunakan.
Buang rahasia dengan aman jika tidak digunakan untuk tujuan yang dimaksudkan dalam jumlah waktu yang diharapkan.

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