HttpSetRequestQueueProperty function

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

Syntax

C++
Copy 


ULONG HttpSetRequestQueueProperty(
  _In_       HANDLE               Handle,
  _In_       HTTP_SERVER_PROPERTY Property,
  _In_       PVOID                pPropertyInformation,
  _In_       ULONG                PropertyInformationLength,
  _Reserved_ ULONG                Reserved,
  _Reserved_ PVOID                pReserved
);

Parameters

Handle [in]

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.

Property [in]

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

PropertyMeaning
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.

 

pPropertyInformation [in]

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
HttpServerQueueLengthPropertyULONG
HttpServer503VerbosityProperty HTTP_503_RESPONSE_VERBOSITY enumeration

 

PropertyInformationLength [in]

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

Reserved [in]

Reserved. Must be zero.

pReserved [in]

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.

ValueMeaning
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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header
Http.h

Library
Httpapi.lib

DLL
Httpapi.dll

See also

HTTP Server API Version 2.0 Functions
HttpCreateRequestQueue
HttpQueryRequestQueueProperty
HttpShutdownRequestQueue
HttpCloseRequestQueue

 

 

Show: