HTTP_SERVICE_CONFIG_SSL_SNI_QUERY structure (http.h)

The HTTP_SERVICE_CONFIG_SSL_SNI_QUERY structure is used to specify a particular Secure Sockets Layer (SSL) Server Name Indication (SNI) certificate record to query in the SSL SNI store. It is passed to the HttpQueryServiceConfiguration function using the pInputConfigInfo parameter when the ConfigId parameter is set to HttpServiceConfigSslSniCertInfo.

Syntax

typedef struct _HTTP_SERVICE_CONFIG_SSL_SNI_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE  QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_SNI_KEY KeyDesc;
  DWORD                           dwToken;
} HTTP_SERVICE_CONFIG_SSL_SNI_QUERY, *PHTTP_SERVICE_CONFIG_SSL_SNI_QUERY;

Members

QueryDesc

One of the following values from the HTTP_SERVICE_CONFIG_QUERY_TYPE enumeration.

Value Meaning
HttpServiceConfigQueryExact
Returns a single SSL SNI certificate record.
HttpServiceConfigQueryNext
Returns a sequence of SSL SNI certificate records in a sequence of calls, as controlled by dwToken.

KeyDesc

If the QueryDesc parameter is equal to HttpServiceConfigQueryExact, then KeyDesc should contain an HTTP_SERVICE_CONFIG_SSL_SNI_KEY structure that identifies the SSL SNI certificate record queried. If the QueryDesc parameter is equal to HTTPServiceConfigQueryNext, then KeyDesc is ignored.

dwToken

If the QueryDesc parameter is equal to HTTPServiceConfigQueryNext, then 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 until all SSL certificate records are returned, at which point HttpQueryServiceConfiguration returns ERROR_NO_MORE_ITEMS.

If the QueryDesc parameter is equal to HttpServiceConfigQueryExact, then dwToken is ignored.

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_SSL_SNI_KEY

HTTP_SERVICE_CONFIG_SSL_SNI_SET

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpSetServiceConfiguration