HTTP_SERVICE_CONFIG_SSL_CCS_QUERY 结构 (http.h)

项目
03/05/2024

指定安全套接字层 (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，则忽略。