HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 结构 (http.h)

指定安全套接字层 (SSL) 配置,以便在调用 HttpQueryServiceConfiguration 函数时在端口上查询 SSL 集中式证书存储 (CCS) 记录。 SSL 证书记录指定,如果端口收到传输层安全性 (TLS) 握手,Http.sys 应咨询 CCS 存储以查找证书。

语法

typedef struct _HTTP_SERVICE_CONFIG_SSL_CCS_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE  QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_CCS_KEY KeyDesc;
  DWORD                           dwToken;
} HTTP_SERVICE_CONFIG_SSL_CCS_QUERY, *PHTTP_SERVICE_CONFIG_SSL_CCS_QUERY;

成员

QueryDesc

HTTP_SERVICE_CONFIG_QUERY_TYPE 枚举中的以下值之一,指示对 HttpQueryServiceConfiguration 的调用是用于检索单个记录的调用,还是检索记录序列的一部分调用。

含义
HttpServiceConfigQueryExact
调用 HttpQueryServiceConfiguration 是调用以检索 KeyDesc 成员指定的单个 SSL CCS 证书记录。
HttpServiceConfigQueryNext
调用 HttpQueryServiceConfiguration 是检索 SSL CCS 证书记录序列的调用序列的一部分。 dwToken 成员的值控制此调用 HttpQueryServiceConfiguration 检索的序列中的记录。

KeyDesc

如果 QueryDesc 成员等于 HttpServiceConfigQueryExact,则标识查询的 SSL CCS 证书记录的HTTP_SERVICE_CONFIG_SSL_CCS_KEY结构。 如果 QueryDesc 等于 HTTPServiceConfigQueryNext,则忽略。

dwToken

如果 QueryDesc 方法等于 HTTPServiceConfigQueryNext(从零开始),则此记录在对 HttpQueryServiceConfiguration 的调用应检索的记录序列中的位置。 换句话说, dwToken 在第一次调用 HttpQueryServiceConfiguration 函数时必须等于零,第二次调用时必须等于 0,在第三次调用上必须等于 2,依此类推。 当调用序列返回所有 SSL 证书记录时, HttpQueryServiceConfiguration 将返回 ERROR_NO_MORE_ITEMS。 如果 QueryDesc 等于 HttpServiceConfigQueryExact,则忽略。

注解

ConfigId 参数设置为 HttpServiceConfigSslCcsCertInfo 时,使用 pInputConfigInfo 参数将此结构传递给 HttpQueryServiceConfiguration 函数。

要求

要求
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
标头 http.h

另请参阅

HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_SSL_CCS_KEY

HttpQueryServiceConfiguration