Edit

HttpSetRequestQueueProperty function (http.h)

  • Article

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