HttpInitialize 函数 (http.h)

  • 项目

HttpInitialize 函数初始化 HTTP 服务器 API 驱动程序，启动它（如果尚未启动），并为调用应用程序分配数据结构以支持响应队列创建和其他操作。 在调用 HTTP 服务器 API 中的任何其他函数之前调用此函数。

语法

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

参数

[in] Version

HTTP 版本。 此参数是一个 HTTPAPI_VERSION 结构。 对于当前版本，请声明 结构的实例，并将其设置为 预定义的值HTTPAPI_VERSION_1 ，然后再将其传递给 HttpInitialize。

[in] Flags

初始化选项，可以包含以下一个或两个值。

值 含义
HTTP_INITIALIZE_CONFIG
 对使用 HTTP 配置函数、HttpSetServiceConfiguration、HttpQueryServiceConfiguration、HttpDeleteServiceConfiguration 和 HttpIsFeatureSupported 的应用程序执行初始化。
HTTP_INITIALIZE_SERVER
 对使用 HTTP 服务器 API 的应用程序执行初始化。

[in, out] pReserved

此参数是保留的，必须为 NULL。

返回值

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

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

值 含义
ERROR_INVALID_PARAMETER
 Flags 参数包含不受支持的值。
其他
 WinError.h 中定义的 系统错误代码 。

注解

应用程序完成时调用 HttpTerminate 。 在 Flags 参数中传递给 HttpInitialize 的所有相同标志也必须传递到 HttpTerminate。 应用程序可以重复调用 HttpInitialize ，前提是以后对 HttpInitialize 的每次调用都与 HttpTerminate 的相应调用匹配。

要求

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

另请参阅