Bagikan melalui

Struktur HTTPSPolicyCallbackData (wincrypt.h)

Struktur SSL_EXTRA_CERT_CHAIN_POLICY_PARA , juga diidentifikasi dengan nama HTTPSPolicyCallbackData, menyimpan informasi kebijakan yang digunakan dalam verifikasi rantai sertifikat klien/server Secure Sockets Layer (SSL).

Sintaks

typedef struct _HTTPSPolicyCallbackData {
  union {
    DWORD cbStruct;
    DWORD cbSize;
  } DUMMYUNIONNAME;
  DWORD dwAuthType;
  DWORD fdwChecks;
  WCHAR *pwszServerName;
} HTTPSPolicyCallbackData, *PHTTPSPolicyCallbackData, SSL_EXTRA_CERT_CHAIN_POLICY_PARA, *PSSL_EXTRA_CERT_CHAIN_POLICY_PARA;

Anggota

DUMMYUNIONNAME

DUMMYUNIONNAME.cbStruct

Nilai DWORD yang menentukan jumlah byte dalam struktur ini.

DUMMYUNIONNAME.cbSize

Nilai DWORD yang menentukan ukuran, dalam byte, dari struktur ini.

dwAuthType

Nilai DWORD yang menentukan jenis autentikasi. Anggota ini bisa menjadi salah satu nilai berikut.

Nilai Makna
AUTHTYPE_CLIENT
1
 Klien sedang diautentikasi.
AUTHTYPE_SERVER
2
 Server sedang diautentikasi.

fdwChecks

Nilai DWORD yang menentukan kesalahan sertifikat untuk diabaikan. Ini bisa menjadi kombinasi bitwise dari bendera berikut.

Nilai Makna
SECURITY_FLAG_IGNORE_REVOCATION
0x00000080
 Abaikan kesalahan yang terkait dengan sertifikat yang dicabut.
SECURITY_FLAG_IGNORE_UNKNOWN_CA
0x00000100
 Abaikan kesalahan yang terkait dengan otoritas sertifikasi yang tidak diketahui.
SECURITY_FLAG_IGNORE_WRONG_USAGE
0x00000200
 Abaikan kesalahan yang terkait dengan penggunaan sertifikat.
SECURITY_FLAG_IGNORE_CERT_CN_INVALID
0x00001000
 Abaikan kesalahan yang terkait dengan sertifikat yang berisi nama umum yang tidak valid.
SECURITY_FLAG_IGNORE_CERT_DATE_INVALID
0x00002000
 Abaikan kesalahan yang terkait dengan sertifikat yang kedaluwarsa.

pwszServerName

Penunjuk ke string karakter lebar yang dihentikan null yang berisi nama server. Anggota ini diabaikan jika nilai anggota dwAuthTypeAUTHTYPE_CLIENT.

Jika string dikodekan Punycode, maka nama server dari sertifikat, baik nama DNS atau nama umum, dikonversi ke string yang dikodekan Punycode. Pencocokan kemudian dilakukan, label demi label jika nama berisi kartubebas, atau kecocokan persis yang tidak peka huruf besar/kecil sebaliknya.

Jika string berisi karakter Unicode di luar kumpulan karakter ASCII dan nama subjek, baik nama DNS atau nama umum, adalah string yang dikodekan Punycode, maka itu adalah Punycode yang dikodekan sebelum perbandingan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header wincrypt.h
  • Last updated on