HTTP_SERVICE_CONFIG_URLACL_QUERY structure (http.h)

The HTTP_SERVICE_CONFIG_URLACL_QUERY structure is used to specify a particular reservation record to query in the URL namespace reservation store. It is passed to the HttpQueryServiceConfiguration function using the pInputConfigInfo parameter when the ConfigId parameter is equal to HttpServiceConfigUrlAclInfo.

Syntax

typedef struct _HTTP_SERVICE_CONFIG_URLACL_QUERY {
  HTTP_SERVICE_CONFIG_QUERY_TYPE QueryDesc;
  HTTP_SERVICE_CONFIG_URLACL_KEY KeyDesc;
  DWORD                          dwToken;
} HTTP_SERVICE_CONFIG_URLACL_QUERY, *PHTTP_SERVICE_CONFIG_URLACL_QUERY;

Members

QueryDesc

One of the following values from the HTTP_SERVICE_CONFIG_QUERY_TYPE enumeration.

HttpServiceConfigQueryExact

Returns a single record.

HttpServiceConfigQueryNext

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

KeyDesc

If the QueryDesc parameter is equal to HttpServiceConfigQueryExact, then KeyDesc should contain an HTTP_SERVICE_CONFIG_URLACL_KEY structure that identifies the reservation record queried.

If the QueryDesc parameter is equal to HttpServiceConfigQueryNext, 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 reservation 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

See also

HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_URLACL_KEY

HTTP_SERVICE_CONFIG_URLACL_SET

HttpQueryServiceConfiguration