HttpCloseRequestQueue function

The HttpCloseRequestQueue function closes the handle to the specified request queue created by HttpCreateRequestQueue.

The application must close the request queue when it is no longer required.

Syntax


ULONG HttpCloseRequestQueue(
  _In_ HANDLE ReqQueueHandle
);

Parameters

ReqQueueHandle [in]

The handle to the request queue that is closed. A request queue is created and its handle returned by a call to the HttpCreateRequestQueue function.

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 application does not have permission to close the request queue. Only the application that created the request queue can close it.

 

Remarks

Applications should not call CloseHandle on the request queue handle; instead, they should call HttpCloseRequestQueue to ensure that all the resources are released.

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
HttpSetRequestQueueProperty
HttpQueryRequestQueueProperty
HttpShutdownRequestQueue

 

 

Show: