HTTP_SSL_CLIENT_CERT_INFO 結構 (HTTP.h)

發行項
02/26/2024

HTTP_SSL_CLIENT_CERT_INFO 結構包含安全套接字層 (SSL) 用戶端憑證的相關數據，可用來判斷憑證是否有效。

語法

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;

成員

CertFlags

指出憑證是否有效的旗標。此成員的可能值為從 SSPI 傳回的 SSPI 狀態代碼，或從 CERT_CHAIN_POLICY_STATUS 結構的 dwError 成員傳回下列其中一個旗標：

CERT_E_EXPIRED

CERT_E_UNTRUSTEDCA

CERT_E_WRONG_USAGE

CERT_E_UNTRUSTEDROOT

CERT_E_REVOKED

CERT_E_CN_NO_MATCH

CertEncodedSize

憑證的大小，以位元組為單位。

pCertEncoded

實際憑證的指標。

Token

存取令牌的句柄。如果使用 HttpSetServiceConfiguration 函式設定HTTP_SERVICE_CONFIG_SSL_FLAG_USE_DS_MAPPER旗標，且客戶端憑證已成功對應至操作系統用戶帳戶，則此成員會包含有效存取令牌的句柄。不再需要 HTTP_SSL_CLIENT_CERT_INFO 結構時，請藉由關閉句柄明確地釋放此令牌。

CertDeniedByMapper

保留的。

備註

HTTP_SSL_CLIENT_CERT_INFO 結構是由 HTTP_SSL_INFO 結構的 pClientCertInfo 成員所指向，且由 HttpReceiveClientCertificate 函式用來透過 pSslClientCertInfo 參數傳回用戶端憑證的相關數據。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
標頭	http.h

另請參閱

HTTP 伺服器 API 1.0 版結構

HTTP_SSL_INFO

HttpReceiveClientCertificate

共用方式為