Fungsi CryptUIDlgSelectCertificate

Fungsi CryptUIDlgSelectCertificate menampilkan kotak dialog yang memungkinkan pengguna untuk memilih sertifikat.

Sintaks

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parameter

pcsc [in]

Penunjuk ke struktur CRYPTUI_SELECTCERTIFICATE_STRUCT yang berisi informasi tentang kotak dialog untuk ditampilkan.

Menampilkan nilai

Penunjuk ke struktur CERT_CONTEXT yang mewakili sertifikat yang dipilih oleh pengguna. Setelah selesai menggunakan sertifikat ini, Anda harus meneruskan penunjuk ini ke fungsi CertFreeCertificateContext untuk mengurangi jumlah referensi konteks sertifikat.

Jika anggota dwFlags dari struktur pcsc tidak berisi bendera CRYPTUI_SELECTCERT_MULTISELECT , nilai pengembalian NULL berarti bahwa pengguna menutup kotak dialog tanpa memilih sertifikat.

Jika anggota dwFlags dari struktur pcsc memang berisi bendera CRYPTUI_SELECTCERT_MULTISELECT , fungsi ini selalu mengembalikan NULL. Sertifikat yang dipilih akan terkandung dalam penyimpanan sertifikat yang diwakili oleh anggota hSelectedCertStorepcsc. Jika jumlah sertifikat di penyimpanan sama sebelum dan sesudah memanggil CryptUIDlgSelectCertificate, pengguna menutup kotak dialog tanpa memilih sertifikat apa pun.

Keterangan

Jika anggota dwFlags dari struktur CRYPTUI_SELECTCERTIFICATE_STRUCT diatur ke CRYPTUI_SELECTCERT_LEGACY, dialog warisan ditampilkan. Jika tidak, dialog pemilihan sertifikat saat ini ditampilkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan	Windows 7 [hanya aplikasi desktop]
Pustaka	Cryptui.lib
DLL	Cryptui.dll
Nama Unicode dan ANSI	CryptUIDlgSelectCertificateW (Unicode) dan CryptUIDlgSelectCertificateA (ANSI)

Lihat juga

CRYPTUI_SELECTCERTIFICATE_STRUCT