Export (0) Print
Expand All

HTTP_SERVICE_CONFIG_SSL_SNI_QUERY structure

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_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.

ValueMeaning
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

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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft