Функция HttpCreateServerSession (http.h)

Статья
08/24/2023

Функция HttpCreateServerSession создает сеанс сервера для указанной версии.

Синтаксис

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

Параметры

[in] Version

Структура HTTPAPI_VERSION, указывающая версию сеанса сервера. Для версии 2.0 объявите экземпляр структуры и присвойте ему предопределенное значение HTTPAPI_VERSION_2 перед передачей в HttpCreateServerSession.

Версия должна быть 2.0; HttpCreateServerSession не поддерживает очереди запросов версии 1.0.

[out] ServerSessionId

Указатель на переменную, которая получает идентификатор сеанса сервера.

[in] Reserved

Зарезервировано. Должен равняться нулю.

Возвращаемое значение

Если функция завершается успешно, она возвращает NO_ERROR.

Если функция завершается сбоем, она возвращает один из следующих кодов ошибок.

Значение	Значение
ERROR_REVISION_MISMATCH	Переданная версия является недопустимой или неподдерживаемой.
ERROR_INVALID_PARAMETER	Параметр pServerSessionId имеет значение NULL или зарезервировано не равно нулю.

Сеансы сервера владеют набором групп URL-адресов. Они представляют собой контейнеры конфигурации верхнего уровня для сведений о конфигурации, которые применяются ко всем созданным в них группам URL-адресов. Дополнительные сведения о настройке сеанса сервера см. в разделе HttpSetServerSessionProperty.

API HTTP-сервера не поддерживает асинхронный ввод-вывод для сеансов сервера.

Если сеанс сервера больше не требуется или до завершения работы приложения, приложение должно удалить сеанс сервера, вызвав HttpCloseServerSession. При удалении сеанса сервера все связанные группы URL-адресов также автоматически удаляются.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	http.h
Библиотека	Httpapi.lib
DLL	Httpapi.dll