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

Статья
08/24/2023

Функция HttpSetUrlGroupProperty задает новое свойство или изменяет существующее свойство для указанной группы URL-адресов.

Синтаксис

HTTPAPI_LINKAGE ULONG HttpSetUrlGroupProperty(
  [in] HTTP_URL_GROUP_ID    UrlGroupId,
  [in] HTTP_SERVER_PROPERTY Property,
  [in] PVOID                PropertyInformation,
  [in] ULONG                PropertyInformationLength
);

Параметры

[in] UrlGroupId

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

[in] Property

Член перечисления HTTP_SERVER_PROPERTY , описывающий измененный или заданный тип свойства. Оно может быть одним из следующих.

Свойство	Значение
HttpServerAuthenticationProperty	Включает проверку подлинности на стороне сервера для группы URL-адресов с использованием схем базовой проверки подлинности, NTLM, Negotiate и Дайджест-проверки подлинности.
HttpServerExtendedAuthenticationProperty	Включает проверку подлинности на стороне сервера для группы URL-адресов, используя схему проверки подлинности Kerberos.
HttpServerQosProperty	Это значение сопоставляется с универсальной структурой HTTP_QOS_SETTING_INFO , для QosType задано значение HttpQosSettingTypeBandwidth или HttpQosSettingTypeConnectionLimit. Если httpQosSettingTypeBandwidth, изменяет или задает регулирование пропускной способности для группы URL-адресов. Если HttpQosSettingTypeConnectionLimit, изменяет или задает максимальное количество необработанных подключений, обслуживаемых для группы URL-адресов в любое время.
HttpServerBindingProperty	Изменяет или задает связь группы URL-адресов с очередью запросов.
HttpServerLoggingProperty	Изменяет или задает ведение журнала для группы URL-адресов.
HttpServerStateProperty	Изменяет или задает состояние группы URL-адресов. Состояние можно включить или отключить.
HttpServerTimeoutsProperty	Изменяет или задает ограничения времени ожидания подключения для группы URL-адресов.
HttpServerChannelBindProperty	Включает проверку подлинности на стороне сервера, которая использует маркер привязки канала (CBT).

[in] PropertyInformation

Указатель на буфер, содержащий сведения о свойстве.

pPropertyInformation указывает на одну из следующих структур сведений о свойствах на основе заданного свойства.

Свойство	Структура
HttpServerAuthenticatonProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerExtendedAuthenticationProperty	HTTP_SERVER_AUTHENTICATION_INFO
HttpServerQosProperty	HTTP_QOS_SETTING_INFO
HttpServerBindingProperty	HTTP_BINDING_INFO
HttpServerLoggingProperty	HTTP_LOGGING_INFO
HttpServerStateProperty	HTTP_STATE_INFO
HttpServerTimeoutsProperty	HTTP_TIMEOUT_LIMIT_INFO
HttpServerChannelBindProperty	HTTP_CHANNEL_BIND_INFO

[in] PropertyInformationLength

Длина (в байтах) буфера, на который указывает параметр pPropertyInformation .

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Тип свойства, указанный в параметре Property, не поддерживается для групп URL-адресов. Параметр pPropertyInformation имеет значение NULL. Параметр PropertyInformationLength равен нулю. Параметр UrlGroupId не содержит допустимый сеанс сервера. Приложение не имеет разрешения на задание свойств группы URL-адресов. Только приложение, создающее группу URL-адресов, может задавать свойства.

Значение

ERROR_INVALID_PARAMETER

Тип свойства, указанный в параметре Property, не поддерживается для групп URL-адресов.

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

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

Параметр UrlGroupId не содержит допустимый сеанс сервера.

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

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

Требования


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