httpCreateHttpHandle 函数 (http.h)
HttpCreateHttpHandle 函数为调用应用程序创建 HTTP 请求队列,并返回一个句柄。
从 HTTP 服务器 API 版本 2.0 开始,应用程序应调用 HttpCreateRequestQueue 来创建请求队列;不应使用 HttpCreateHttpHandle 。
语法
HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
[out] PHANDLE RequestQueueHandle,
[in] ULONG Reserved
);
parameters
[out] RequestQueueHandle
指向接收请求队列句柄的变量的指针。
[in] Reserved
保留。 此参数必须为零。
返回值
如果函数成功,则返回值 NO_ERROR。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
调用应用程序在调用此函数之前未调用 HttpInitialize 。 |
|
WinError.h 中定义的 系统错误代码 。 |
注解
请求队列使调用应用程序能够接收特定 URL 的请求。 调用应用程序使用 HttpAddUrl 函数指定应接收请求的 URL。
应用程序应使用单个请求队列来接收请求。 从单个进程使用多个请求队列不会增加响应时间或吞吐量。
当应用程序完成接收请求后,它应调用 CloseHandle 函数来关闭句柄。
要求
最低受支持的客户端 | Windows Vista、Windows XP SP2 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | http.h |
Library | Httpapi.lib |
DLL | Httpapi.dll |