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.

Syntax

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Parameters

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

Remarks

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.

Requirements

See also

HTTP Server API Version 1.0 Functions

HttpAddUrl

HttpCreateRequestQueue