HttpSetRequestQueueProperty function (http.h)

The HttpSetRequestQueueProperty function sets a new property or modifies an existing property on the request queue identified by the specified handle.

Syntax

HTTPAPI_LINKAGE ULONG HttpSetRequestQueueProperty(
  [in] HANDLE               RequestQueueHandle,
  [in] HTTP_SERVER_PROPERTY Property,
  [in] PVOID                PropertyInformation,
  [in] ULONG                PropertyInformationLength,
  [in] ULONG                Reserved1,
  [in] PVOID                Reserved2
);

Parameters

[in] RequestQueueHandle

The handle to the request queue on which the property is set. A request queue is created and its handle returned by a call to the HttpCreateRequestQueue function.

[in] Property

A member of the HTTP_SERVER_PROPERTY enumeration describing the property type that is set. This must be one of the following:

Property	Meaning
HttpServer503VerbosityProperty	Modifies or sets the current verbosity level of 503 responses generated for the request queue.
HttpServerQueueLengthProperty	Modifies or sets the limit on the number of outstanding requests in the request queue.
HttpServerStateProperty	Modifies or sets the state of the request queue. The state must be either active or inactive.

[in] PropertyInformation

A pointer to the buffer that contains the property information.

pPropertyInformation points to one of the following property information types based on the property that is set.

Property	Configuration Type
HttpServerStateProperty	HTTP_ENABLED_STATE enumeration
HttpServerQueueLengthProperty	ULONG
HttpServer503VerbosityProperty	HTTP_503_RESPONSE_VERBOSITY enumeration

[in] PropertyInformationLength

The length, in bytes, of the buffer pointed to by the pPropertyInformation parameter.

[in] Reserved1

Reserved. Must be zero.

[in] Reserved2

Reserved. Must be NULL.

Return value

If the function succeeds, it returns NO_ERROR.

If the function fails, it returns one of the following error codes.

Value	Meaning
ERROR_INVALID_PARAMETER	The Reserved parameter is not zero or the pReserved parameter is not NULL. The property type specified in the Property parameter is not supported for request queues. The pPropertyInformation parameter is NULL. The PropertyInformationLength parameter is zero. The application does not have permission to set properties on the request queue. Only the application that created the request queue can set the properties.
ERROR_NOT_SUPPORTED	The handle to the request queue is an HTTP version 1.0 handle. Property management is only supported on HTTP version 2.0 or later request queues.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	http.h
Library	Httpapi.lib
DLL	Httpapi.dll

See also

HTTP Server API Version 2.0 Functions

HttpCloseRequestQueue

HttpCreateRequestQueue

HttpQueryRequestQueueProperty

HttpShutdownRequestQueue