HttpCreateHttpHandle function (http.h)

The HttpCreateHttpHandle function creates an HTTP request queue for the calling application and returns a handle to it.

Starting with HTTP Server API Version 2.0, applications should call HttpCreateRequestQueue to create the request queue; HttpCreateHttpHandle should not be used.


  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved


[out] RequestQueueHandle

A pointer to a variable that receives a handle to the request queue.

[in] Reserved

Reserved. This parameter must be zero.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Meaning
The calling application did not call HttpInitialize before calling this function.
A system error code defined in WinError.h.


The request queue enables the calling application to receive requests for particular URLs. The calling application uses the HttpAddUrl function to specify the URL for which it should receive requests.

An application should use a single request queue to receive requests. Using multiple request queues from a single process does not increase response time or throughput.

When an application has finished receiving requests, it should call the CloseHandle function to close the handle.


Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header http.h
Library Httpapi.lib
DLL Httpapi.dll

See also

HTTP Server API Version 1.0 Functions