Поделиться через


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

Функция 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

См. также раздел

Функции API HTTP-сервера версии 2.0

HttpCloseServerSession

HttpCreateServerSession

HttpQueryServerSessionProperty

HttpSetServerSessionProperty