Edit

Share via

HTTP_SERVICE_CONFIG_SSL_CCS_QUERY structure (http.h)

  • Article

Specifies a Secure Sockets Layer (SSL) configuration to query for an SSL Centralized Certificate Store (CCS) record on the port when you call the HttpQueryServiceConfiguration function. The SSL certificate record specifies that Http.sys should consult the CCS store to find certificates if the port receives a Transport Layer Security (TLS) handshake.

Syntax

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;

Members

QueryDesc

One of the following values from the HTTP_SERVICE_CONFIG_QUERY_TYPE enumeration that indicates whether the call to HttpQueryServiceConfiguration is a call to retrieve a single record or part of a sequence of calls to retrieve a sequence of records.

Value Meaning
HttpServiceConfigQueryExact
 The call to HttpQueryServiceConfiguration is call to retrieve a single SSL CCS certificate record, which the KeyDesc member specifies.
HttpServiceConfigQueryNext
 The call to HttpQueryServiceConfiguration is part of a sequence of calls to retrieve a sequence of SSL CCS certificate records. The value of the dwToken member controls which record in the sequence that this call to HttpQueryServiceConfiguration retrieves.

KeyDesc

An HTTP_SERVICE_CONFIG_SSL_CCS_KEY structure that identifies the SSL CCS certificate record queried, if the QueryDesc member is equal to HttpServiceConfigQueryExact. Ignored if QueryDesc is equal to HTTPServiceConfigQueryNext.

dwToken

The position of the record in the sequence of records that this call to HttpQueryServiceConfiguration should retrieve if the QueryDesc method equals HTTPServiceConfigQueryNext, starting from zero. In other words, dwToken must be equal to zero on the first call to the HttpQueryServiceConfiguration function, one on the second call, two on the third call, and so forth. When the sequence of calls has returned all SSL certificate records, HttpQueryServiceConfiguration returns ERROR_NO_MORE_ITEMS. Ignored if the QueryDesc is equal to HttpServiceConfigQueryExact.

Remarks

Pass this structure to the HttpQueryServiceConfiguration function by using the pInputConfigInfo parameter when the ConfigId parameter is set to HttpServiceConfigSslCcsCertInfo.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Header http.h

See also

HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_SSL_CCS_KEY

HttpQueryServiceConfiguration