httpCreateHttpHandle 函数 (http.h)

HttpCreateHttpHandle 函数为调用应用程序创建 HTTP 请求队列，并返回一个句柄。

从 HTTP 服务器 API 版本 2.0 开始，应用程序应调用 HttpCreateRequestQueue 来创建请求队列;不应使用 HttpCreateHttpHandle 。

语法

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

[out] RequestQueueHandle

指向接收请求队列句柄的变量的指针。

[in] Reserved

保留。此参数必须为零。

如果函数成功，则返回值 NO_ERROR。

如果函数失败，则返回值为以下错误代码之一。

值	含义
ERROR_DLL_INIT_FAILED	调用应用程序在调用此函数之前未调用 HttpInitialize 。
其他	WinError.h 中定义的系统错误代码。

请求队列使调用应用程序能够接收特定 URL 的请求。调用应用程序使用 HttpAddUrl 函数指定应接收请求的 URL。

应用程序应使用单个请求队列来接收请求。从单个进程使用多个请求队列不会增加响应时间或吞吐量。

当应用程序完成接收请求后，它应调用 CloseHandle 函数来关闭句柄。


最低受支持的客户端	Windows Vista、Windows XP SP2 [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	http.h
Library	Httpapi.lib
DLL	Httpapi.dll