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

Статья
08/24/2023

Функция HttpCreateUrlGroup создает группу URL-адресов в указанном сеансе сервера.

Синтаксис

HTTPAPI_LINKAGE ULONG HttpCreateUrlGroup(
  [in]  HTTP_SERVER_SESSION_ID ServerSessionId,
  [out] PHTTP_URL_GROUP_ID     pUrlGroupId,
  [in]  ULONG                  Reserved
);

Параметры

[in] ServerSessionId

Идентификатор сеанса сервера, в котором создается группа URL-адресов.

[out] pUrlGroupId

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

[in] Reserved

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

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Параметр ServerSessionId указывает на несуществующий сеанс сервера. Параметр pUrlGroupId имеет значение NULL. Параметр Reserved не равен нулю.

Значение

ERROR_INVALID_PARAMETER

Параметр ServerSessionId указывает на несуществующий сеанс сервера.

Параметр pUrlGroupId имеет значение NULL.

Параметр Reserved не равен нулю.

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

После создания группы URL-адресов она должна быть связана с очередью запросов для получения запросов. Чтобы связать группу URL-адресов с очередью запросов, приложение вызывает HttpSetUrlGroupProperty со свойством HttpServerBindingProperty . Если это свойство не задано, соответствующие запросы для группы URL-адресов не доставляются в очередь запросов, а API HTTP-сервера создает ответ 503.

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

Группа URL-адресов изначально создается как пустая группа. URL-адреса необходимо добавить в группу путем вызова HttpAddUrlToUrlGroup.

Приложение может создать несколько групп URL-адресов по следующим причинам:

Настройка различных конфигураций для разных частей пространства имен URL-адресов, в которых он прослушивается.
Настройка отдельных очередей запросов для разных частей пространства имен URL-адресов, в которых он прослушивается.

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

API HTTP-сервера не поддерживает асинхронный ввод-вывод в группах URL-адресов.

Если группа URL-адресов больше не нужна или до завершения работы приложения она должна удалить группу URL-адресов, вызвав HttpCloseUrlGroup.

Группа URL-адресов создается с той же версией, что и сеанс сервера, в котором она создается.

Требования


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