Функция HttpCreateUrlGroup (http.h)
Функция 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
Если функция завершается сбоем, она возвращает один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Параметр 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 |