HttpQueryRequestQueueProperty function (http.h)
The HttpQueryRequestQueueProperty function queries a property of the request queue identified by the specified handle.
Syntax
HTTPAPI_LINKAGE ULONG HttpQueryRequestQueueProperty(
HANDLE RequestQueueHandle,
[in] HTTP_SERVER_PROPERTY Property,
[out] PVOID PropertyInformation,
[in] ULONG PropertyInformationLength,
[in] ULONG Reserved1,
[out, optional] PULONG ReturnLength,
[in] PVOID Reserved2
);
Parameters
RequestQueueHandle
[in] Property
A member of the HTTP_SERVER_PROPERTY enumeration that describes the property type that is set. This can be one of the following:
[out] PropertyInformation
A pointer to the buffer that receives the property information.
pPropertyInformation points to one of the following property information values based on the property that is set.
Property | Value |
---|---|
HttpServerStateProperty | HTTP_ENABLED_STATE (enumeration member) |
HttpServerQueueLengthProperty | ULONG |
HttpServer503VerbosityProperty | HTTP_503_RESPONSE_VERBOSITY (enumeration member) |
[in] PropertyInformationLength
The length, in bytes, of the buffer pointed to by the pPropertyInformation parameter.
[in] Reserved1
Reserved. Must be zero.
[out, optional] ReturnLength
The number, in bytes, returned in the pPropertyInformation buffer if not NULL.
If the output buffer is too small, the call fails with a return value of ERROR_MORE_DATA. The value pointed to by pReturnLength can be used to determine the minimum length of the buffer required for the call to succeed.
[in] Reserved2
This parameter is reserved and 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 |
---|---|
|
The Reserved parameter is not zero or the pReserved parameter is not NULL.
The property type specified in the Property parameter is not supported on request queues. The pPropertyInformation parameter is NULL. The PropertyInformationLength parameter is zero. The application does not have permission to open the request queue. |
|
The size, in bytes, of the buffer pointed to by the pPropertyInformation parameter is too small to receive the property information. Call the function again with a buffer at least as large as the size pointed to by pReturnLength on exit. |
|
The handle to the request queue is an HTTP version 1.0 handle. Property management is only supported for HTTP version 2.0 and 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 |