Bagikan melalui

struktur CERT_SELECT_CRITERIA (wincrypt.h)

  • Artikel

Struktur CERT_SELECT_CRITERIA menentukan kriteria pemilihan yang diteruskan ke fungsi CertSelectCertificateChains .

Sintaks

typedef struct _CERT_SELECT_CRITERIA {
  DWORD dwType;
  DWORD cPara;
  void  **ppPara;
} CERT_SELECT_CRITERIA, *PCERT_SELECT_CRITERIA;

Anggota

dwType

Menentukan jenis kriteria pilihan yang digunakan untuk anggota ppPara . Anggota ini bisa memiliki salah satu nilai berikut.

Nilai Makna
CERT_SELECT_BY_ENHKEY_USAGE
1
 Pilih sertifikat berdasarkan penggunaan kunci tertentu yang ditingkatkan. Ketika bendera ini diatur, ppPara harus mereferensikan string ANSI pengidentifikasi objek yang dihentikan null (OID) yang menentukan penggunaan kunci yang ditingkatkan.

Kriteria ini dievaluasi pada sertifikat.
CERT_SELECT_BY_KEY_USAGE
2
 Pilih sertifikat berdasarkan ekstensi szOID_KEY_USAGE tertentu dalam sertifikat. Ketika bendera ini diatur, anggota ppPara harus mereferensikan struktur CERT_EXTENSION di mana nilai ekstensi adalah DWORD yang mengidentifikasi bit Penggunaan Kunci.

Kriteria ini dievaluasi pada sertifikat.
CERT_SELECT_BY_POLICY_OID
3
 Pilih sertifikat berdasarkan kebijakan penerbitan tertentu. Anggota ppPara harus mereferensikan string ANSI OID yang dihentikan null dari kebijakan penerbitan yang diinginkan.

Kriteria ini dievaluasi pada kebijakan penerbitan rantai sertifikat.
CERT_SELECT_BY_PROV_NAME
4
 Pilih sertifikat berdasarkan penyedia kunci privat tertentu. Anggota ppPara harus mereferensikan string Unicode yang dihentikan null yang mewakili nama penyedia.
CERT_SELECT_BY_EXTENSION
5
 Pilih sertifikat berdasarkan keberadaan ekstensi tertentu dan nilai opsional yang ditentukan. Anggota ppPara harus mereferensikan struktur CERT_EXTENSION yang menentukan OID ekstensi dan nilai terkait.
CERT_SELECT_BY_SUBJECT_HOST_NAME
6
 Pilih sertifikat berdasarkan Nama HOST DNS Subjek. Anggota ppPara harus mereferensikan string Unicode yang dihentikan null yang berisi nama host subjek. Pemilihan yang dilakukan berdasarkan bendera ini sama dengan evaluasi anggota pwszServerName dari struktur SSL_EXTRA_CERT_CHAIN_POLICY_PARA selama panggilan ke fungsi CertVerifyCertificateChainPolicy .

Kriteria ini dievaluasi pada sertifikat.
CERT_SELECT_BY_ISSUER_ATTR
7
 Pilih sertifikat berdasarkan elemen nama yang dibedakan relatif (RDN) dari penerbit sertifikat. Anggota ppPara harus mereferensikan struktur CERT_RDN yang berisi elemen RDN penerbit.

Kriteria ini dievaluasi pada rantai sertifikat.
CERT_SELECT_BY_SUBJECT_ATTR
8
 Pilih sertifikat berdasarkan elemen RDN di Subjek sertifikat. Anggota ppPara harus menjadi referensi ke struktur CERT_RDN yang berisi elemen RDN subjek.

Kriteria ini dievaluasi pada sertifikat.
CERT_SELECT_BY_ISSUER_NAME
9
 Pilih sertifikat berdasarkan penerbit sertifikat. Anggota ppPara harus menjadi referensi ke struktur CERT_NAME_BLOB yang berisi nama penerbit.

Kriteria ini dievaluasi pada rantai sertifikat.
CERT_SELECT_BY_PUBLIC_KEY
10
 Pilih sertifikat berdasarkan kunci umum sertifikat. Anggota ppPara harus mereferensikan pointer ke struktur CERT_PUBLIC_KEY_INFO yang berisi kunci umum.

Kriteria ini dievaluasi pada sertifikat.
CERT_SELECT_BY_TLS_SIGNATURES
11
 Pilih sertifikat berdasarkan persyaratan Tanda Tangan Protokol Keamanan Lapisan Transportasi (TLS). Anggota ppPara harus mereferensikan struktur SecPkgContext_SupportedSignatures .

Kriteria ini dievaluasi pada sertifikat.

cPara

Nilai DWORD yang menentukan jumlah atribut pencarian yang ditentukan dalam anggota ppPara .

ppPara

Penunjuk ke penunjuk ke satu atau beberapa nilai pilihan. Jenis data tergantung pada jenis pilihan yang ditentukan oleh anggota dwType . Jika ada lebih dari satu nilai pilihan, aplikasi hanya harus cocok dengan satu nilai.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Header wincrypt.h