struktur CRYPTUI_SELECTCERTIFICATE_STRUCT

Struktur CRYPTUI_SELECTCERTIFICATE_STRUCT berisi informasi tentang kotak dialog yang ditampilkan oleh fungsi CryptUIDlgSelectCertificate .

Sintaks

typedef struct _CRYPTUI_SELECTCERTIFICATE_STRUCT {
  DWORD               dwSize;
  HWND                hwndParent;
  DWORD               dwFlags;
  LPCTSTR             szTitle;
  DWORD               dwDontUseColumn;
  LPCTSTR             szDisplayString;
  PFNCFILTERPROC      pFilterCallback;
  PFNCCERTDISPLAYPROC pDisplayCallback;
  void                *pvCallbackData;
  DWORD               cDisplayStores;
  HCERTSTORE          *rghDisplayStores;
  DWORD               cStores;
  HCERTSTORE          *rghStores;
  DWORD               cPropSheetPages;
  LPCPROPSHEETPAGE    rgPropSheetPages;
  HCERTSTORE          hSelectedCertStore;
} CRYPTUI_SELECTCERTIFICATE_STRUCT, *PCRYPTUI_SELECTCERTIFICATE_STRUCT;

Anggota

dwSize

Ukuran, dalam byte, dari struktur ini.

hwndParent

Gagang jendela induk kotak dialog. Jika nilai ini NULL, jendela induk adalah jendela desktop default.

dwFlags

Menentukan opsi tambahan untuk fungsi CryptUIDlgSelectCertificate . Ini bisa nol atau bitwise ATAU dari nilai berikut.

Nilai	Makna
CRYPTUI_SELECTCERT_ADDFROMDS	Dicadangkan.
CRYPTUI_SELECTCERT_LEGACY	Menentukan bahwa dialog warisan akan ditampilkan.
CRYPTUI_SELECTCERT_MULTISELECT	Memungkinkan pengguna memilih lebih dari satu sertifikat dalam kotak dialog. Jika bendera ini diatur, fungsi CryptUIDlgSelectCertificate selalu mengembalikan NULL. Anggota hSelectedCertStore dari struktur ini harus berisi handel ke penyimpanan sertifikat. Sertifikat yang dipilih oleh pengguna akan ditambahkan ke penyimpanan ini.
CRYPTUI_SELECTCERT_PUT_WINDOW_TOPMOST	Memaksa UI kriptografi menjadi jendela atas di layar.

 

szTitle

Judul tampilan untuk kotak dialog. Jika nilai anggota ini adalah NULL, judul default "Pilih Sertifikat" digunakan.

dwDontUseColumn

Bendera yang dapat digabungkan untuk mengecualikan kolom tampilan.

Nilai	Makna
CRYPTUI_SELECT_ISSUEDTO_COLUMN 1 (0x1)	Jangan tampilkan informasi ISSUEDTO .
CRYPTUI_SELECT_ISSUEDBY_COLUMN 2 (0x2)	Jangan tampilkan informasi ISSUEDBY .
CRYPTUI_SELECT_INTENDEDUSE_COLUMN 4 (0x4)	Jangan tampilkan informasi IntendedUse .
CRYPTUI_SELECT_FRIENDLYNAME_COLUMN 8 (0x8)	Jangan tampilkan informasi nama.
CRYPTUI_SELECT_LOCATION_COLUMN 16 (0x10)	Jangan tampilkan informasi lokasi.
CRYPTUI_SELECT_EXPIRATION_COLUMN 32 (0x20)	Jangan tampilkan informasi kedaluwarsa.

 

szDisplayString

Teks yang ditampilkan dalam kotak dialog untuk menginstruksikan pengguna. Jika nilai anggota ini adalah NULL, string default "Pilih sertifikat yang ingin Anda gunakan" akan digunakan.

pFilterCallback

Penunjuk ke fungsi panggilan balik PFNCFILTERPROC yang memfilter sertifikat yang ditampilkan dalam kotak dialog.

pDisplayCallback

Penunjuk ke fungsi panggilan balik PFNCCERTDISPLAYPROC yang menampilkan sertifikat yang dipilih pengguna untuk ditampilkan.

pvCallbackData

Data tambahan yang diteruskan ke fungsi panggilan balik yang ditentukan oleh anggota pFilterCallback dan pDisplayCallback .

cDisplayStores

Jumlah penyimpanan sertifikat dalam array rghDisplayStores .

rghDisplayStores

Penunjuk ke array penyimpanan yang berisi sertifikat yang tersedia untuk dipilih dalam kotak dialog.

cStores

Jumlah penyimpanan sertifikat dalam array rghStores .

rghStores

Penunjuk ke array penyimpanan sertifikat untuk dicari saat membangun rantai sertifikat dan memverifikasi kepercayaan untuk sertifikat yang ditampilkan dalam kotak dialog.

cPropSheetPages

Jumlah halaman properti dalam array rgPropSheetPages .

rgPropSheetPages

Penunjuk ke array struktur PROPSHEETPAGE yang mewakili halaman properti yang diteruskan ke kotak dialog tampilan sertifikat saat sertifikat dipilih untuk ditampilkan.

hSelectedCertStore

Handel ke penyimpanan sertifikat yang dibuat oleh penelepon. Sertifikat yang dipilih oleh pengguna ditambahkan ke penyimpanan ini. Jika jumlah sertifikat di penyimpanan ini sama sebelum dan sesudah memanggil CryptUIDlgSelectCertificate, pengguna menutup kotak dialog tanpa memilih sertifikat apa pun.

Anggota ini tidak digunakan jika anggota dwFlags struktur ini tidak berisi bendera CRYPTUI_SELECTCERT_MULTISELECT .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Nama Unicode dan ANSI	CRYPTUI_SELECTCERTIFICATE_STRUCTW (Unicode) dan CRYPTUI_SELECTCERTIFICATE_STRUCTA (ANSI)

Lihat juga

CryptUIDlgSelectCertificate