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。
如果该函数失败，它将返回以下错误代码之一。
| 值 | 含义 |
|---|---|
|
传递的版本无效或不受支持。 |
|
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 |