HTTP_SERVICE_CONFIG_SSL_QUERY Structure

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 equal to HttpServiceConfigSSLCertInfo.

Syntax

C++
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

Minimum supported clientWindows Vista, Windows XP with SP2
Minimum supported serverWindows Server 2003
HeaderHttp.h

See Also

HttpQueryServiceConfiguration
HTTP_SERVICE_CONFIG_QUERY_TYPE
HTTP_SERVICE_CONFIG_SSL_SET

Send comments about this topic to Microsoft

Build date: 11/19/2009

Tags :


Page view tracker