struktur CERT_SELECT_STRUCT_A (cryptdlg.h)

Artikel
08/22/2023

Struktur CERT_SELECT_STRUCT berisi kriteria untuk memilih sertifikat yang disajikan dalam kotak dialog pemilihan sertifikat. Struktur ini digunakan dalam fungsi CertSelectCertificate .

Sintaks

typedef struct tagCSSA {
  DWORD           dwSize;
  HWND            hwndParent;
  HINSTANCE       hInstance;
  LPCSTR          pTemplateName;
  DWORD           dwFlags;
  LPCSTR          szTitle;
  DWORD           cCertStore;
  HCERTSTORE      *arrayCertStore;
  LPCSTR          szPurposeOid;
  DWORD           cCertContext;
  PCCERT_CONTEXT  *arrayCertContext;
  LPARAM          lCustData;
  PFNCMHOOKPROC   pfnHook;
  PFNCMFILTERPROC pfnFilter;
  LPCSTR          szHelpFileName;
  DWORD           dwHelpId;
  HCRYPTPROV      hprov;
} CERT_SELECT_STRUCT_A, *PCERT_SELECT_STRUCT_A;

Anggota

dwSize

Ukuran, dalam byte, dari struktur ini.

hwndParent

Handel ke jendela induk dari kotak dialog apa pun yang dihasilkan CertSelectCertificate .

hInstance

Handel ke modul yang file yang dapat dieksekusi berisi templat kotak dialog.

pTemplateName

Jika bendera CSS_ENABLETEMPLATE diatur di anggota dwFlags , atur pTemplateName ke pointer ke objek memori global yang berisi templat yang digunakan DialogBoxIndirectParam untuk membuat kotak dialog. Templat kotak dialog terdiri dari header yang menjelaskan kotak dialog. Header diikuti oleh satu atau beberapa blok data tambahan yang menjelaskan setiap kontrol dalam kotak dialog. Templat dapat menggunakan format standar atau format yang diperluas.

Jika bendera CSS_ENABLETEMPLATEHANDLE diatur dalam dwFlags, pTemplateName menentukan templat kotak dialog. pTemplateName adalah penunjuk ke string karakter yang dihentikan null yang menentukan nama templat kotak dialog atau nilai bilangan bulat yang menentukan pengidentifikasi sumber daya templat kotak dialog. Jika menentukan pengidentifikasi sumber daya, kata urutan tingginya harus nol dan kata urutan rendahnya harus berisi pengidentifikasi. Salah satu cara untuk membuat nilai bilangan bulat ini adalah dengan menggunakan makro MAKEINTRESOURCE .

dwFlags

Anggota ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
CSS_HIDE_PROPERTIES	Sembunyikan tombol Properti .
CSS_ENABLEHOOK	Lewati prosedur kait di pfnHook.
CSS_ALLOWMULTISELECT	Aktifkan multi-pilihan sertifikat. Opsi ini saat ini tidak didukung dan diabaikan.
CSS_SHOW_HELP	Perlihatkan tombol Bantuan .
CSS_ENABLETEMPLATE	Menyebabkan fungsi CertSelectCertificate memanggil fungsi DialogBoxIndirectParam untuk membuat kotak dialog. Untuk informasi selengkapnya, lihat pTemplateName.
CSS_ENABLETEMPLATEHANDLE	Menyebabkan fungsi CertSelectCertificate memanggil fungsi DialogBoxParam untuk membuat kotak dialog. Untuk informasi selengkapnya, lihat pTemplateName.

szTitle

Penunjuk ke string yang berisi teks untuk judul kotak dialog.

cCertStore

Jumlah elemen dalam array arrayCertStore .

arrayCertStore

Penunjuk ke array penyimpanan sertifikat tempat kotak dialog menghitung dan menampilkan sertifikat. Anggota cCertStore berisi jumlah elemen dalam array ini.

szPurposeOid

Penunjuk ke representasi string pengidentifikasi objek (OID) untuk penggunaan kunci yang disempurnakan (EKU). Jika OID disediakan, hanya sertifikat yang menyertakan EKU ini yang akan ditampilkan.

cCertContext

Jumlah elemen dalam array arrayCertContext . Setelah fungsi CertSelectCertificate kembali, anggota ini berisi jumlah sertifikat yang dipilih oleh pengguna. Saat ini, hanya satu sertifikat yang dapat dipilih oleh pengguna.

arrayCertContext

Penunjuk ke array struktur CERT_CONTEXT . Anggota cCertContext menentukan jumlah elemen dalam array ini. Array ini harus berisi setidaknya satu elemen.

Sertifikat yang diwakili oleh struktur ini dipilih ketika kotak dialog yang ditampilkan oleh fungsi CertSelectCertificate awalnya ditampilkan. Saat ini, hanya sertifikat pertama dalam array ini yang digunakan. Sertifikat pertama dalam array ini akan dirilis dengan fungsi CertFreeCertificateContext jika fungsi CertSelectCertificate berhasil. Jika elemen pertama dalam array ini adalah NULL, tidak ada sertifikat yang awalnya dipilih dalam kotak dialog.

Setelah fungsi CertSelectCertificate kembali, array ini berisi sertifikat yang dipilih oleh pengguna. Saat ini, hanya satu sertifikat yang dapat dipilih oleh pengguna.

lCustData

Penunjuk ke array nilai byte yang menyimpan data kustom yang diteruskan ke prosedur filter yang direferensikan oleh pfnFilter. Data kustom ini tidak digunakan oleh fungsi CertSelectCertificate .

pfnHook

Penunjuk fungsi PFNCMHOOKPROC ke fungsi panggilan balik Hook. Fungsi ini dipanggil sebelum pesan diproses oleh kotak dialog. Untuk informasi selengkapnya, lihat Kait.

pfnFilter

Penunjuk fungsi PFNCMFILTERPROC ke fungsi panggilan balik filter. Ini dipanggil untuk menentukan sertifikat mana yang akan ditampilkan oleh kotak dialog.

szHelpFileName

Penunjuk ke string yang dihentikan null yang berisi jalur lengkap ke file Bantuan.

dwHelpId

Pengidentifikasi konteks untuk topik tersebut. Untuk mengetahui informasi selengkapnya, lihat
Aku akan kembali.

hprov

Handel ke Penyedia Layanan Kriptografi (CSP) yang akan digunakan untuk verifikasi sertifikat.

Keterangan

Catatan

Header cryptdlg.h mendefinisikan CERT_SELECT_STRUCT sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	cryptdlg.h

Lihat juga

CertSelectCertificate

Bagikan melalui