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

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

含义
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

另请参阅

HTTP 服务器 API 版本 1.0 函数

HttpAddUrl

HttpCreateRequestQueue