HTTP_SERVICE_CONFIG_SSL_QUERY structure (http.h)

Article
02/22/2024

The HTTP_SERVICE_CONFIG_SSL_QUERY structure is used to specify a particular record to query in the SSL configuration store. It is passed to the HttpQueryServiceConfiguration function using the pInputConfigInfo parameter when the ConfigId parameter is set to HttpServiceConfigSSLCertInfo.

Syntax

typedef struct _HTTP_SERVICE_CONFIG_SSL_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE QueryDesc;
  HTTP_SERVICE_CONFIG_SSL_KEY    KeyDesc;
  DWORD                          dwToken;
} HTTP_SERVICE_CONFIG_SSL_QUERY, *PHTTP_SERVICE_CONFIG_SSL_QUERY;

Members

QueryDesc

One of the following values from the HTTP_SERVICE_CONFIG_QUERY_TYPE enumeration.

HttpServiceConfigQueryExact

Returns a single SSL record.

HttpServiceConfigQueryNext

Returns a sequence of SSL records in a sequence of calls, as controlled by the dwToken parameter.

KeyDesc

If the QueryDesc parameter is equal to HttpServiceConfigQueryExact, then KeyDesc should contain an HTTP_SERVICE_CONFIG_SSL_KEY structure that identifies the SSL 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 Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Header	http.h