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

通过