struktur HTTP_SSL_CLIENT_CERT_INFO (http.h)

Struktur HTTP_SSL_CLIENT_CERT_INFO berisi data tentang sertifikat klien Secure Sockets Layer (SSL) yang dapat digunakan untuk menentukan apakah sertifikat valid.

Sintaks

typedef struct _HTTP_SSL_CLIENT_CERT_INFO {
  ULONG   CertFlags;
  ULONG   CertEncodedSize;
  PUCHAR  pCertEncoded;
  HANDLE  Token;
  BOOLEAN CertDeniedByMapper;
} HTTP_SSL_CLIENT_CERT_INFO, *PHTTP_SSL_CLIENT_CERT_INFO;

Anggota

CertFlags

Bendera yang menunjukkan apakah sertifikat valid. Nilai yang mungkin untuk anggota ini adalah Kode Status SSPI yang dikembalikan dari SSPI atau salah satu bendera berikut dari anggota dwError dari struktur CERT_CHAIN_POLICY_STATUS :

CERT_E_EXPIRED

CERT_E_UNTRUSTEDCA

CERT_E_WRONG_USAGE

CERT_E_UNTRUSTEDROOT

CERT_E_REVOKED

CERT_E_CN_NO_MATCH

CertEncodedSize

Ukuran, dalam byte, sertifikat.

pCertEncoded

Penunjuk ke sertifikat aktual.

Token

Handel ke token akses. Jika bendera HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER diatur menggunakan fungsi HttpSetServiceConfiguration , dan sertifikat klien berhasil dipetakan ke akun pengguna sistem operasi, maka anggota ini berisi handel ke token akses yang valid. Ketika struktur HTTP_SSL_CLIENT_CERT_INFO tidak lagi diperlukan, lepaskan token ini secara eksplisit dengan menutup handel.

CertDeniedByMapper

Dicadangkan.

Keterangan

Struktur HTTP_SSL_CLIENT_CERT_INFO diarahkan oleh anggota pClientCertInfo dari struktur HTTP_SSL_INFO , dan digunakan oleh fungsi HttpReceiveClientCertificate untuk mengembalikan data tentang sertifikat klien melalui parameter pSslClientCertInfo .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	http.h

Lihat juga

Struktur HTTP Server API Versi 1.0

HTTP_SSL_INFO

HttpReceiveClientCertificate