httpCreateServerSession 函数 (http.h)

  • 项目

HttpCreateServerSession 函数为指定版本创建服务器会话。

语法

HTTPAPI_LINKAGE ULONG HttpCreateServerSession(
  [in]  HTTPAPI_VERSION         Version,
  [out] PHTTP_SERVER_SESSION_ID ServerSessionId,
  [in]  ULONG                   Reserved
);

parameters

[in] Version

指示服务器会话版本的HTTPAPI_VERSION结构。 对于版本 2.0，请声明 结构的实例并将其设置为 预定义值HTTPAPI_VERSION_2 ，然后再将其传递给 HttpCreateServerSession。

版本必须为 2.0; HttpCreateServerSession 不支持版本 1.0 请求队列。

[out] ServerSessionId

指向接收服务器会话 ID 的变量的指针。

[in] Reserved

保留。 必须为零。

返回值

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

如果该函数失败，它将返回以下错误代码之一。

值 含义
ERROR_REVISION_MISMATCH
 传递的版本无效或不受支持。
ERROR_INVALID_PARAMETER
 pServerSessionId 参数为 null 或 Reserved 为非零。

注解

服务器会话拥有一组 URL 组。 它们是顶级配置容器，用于获取适用于在它们下创建的所有 URL 组的配置信息。 有关配置服务器会话的详细信息，请参阅 HttpSetServerSessionProperty。

HTTP 服务器 API 不支持服务器会话的异步 I/O。

如果不再需要服务器会话，或在应用程序终止之前，应用程序必须通过调用 HttpCloseServerSession 删除服务器会话。 删除服务器会话时，所有关联的 URL 组也会自动删除。

要求

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

另请参阅

HTTP 服务器 API 版本 2.0 函数

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty