Бөлісу құралы:

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

Функция 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-адресов, может задавать свойства.

Комментарии

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

Требования

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

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

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

HttpAddUrlToUrlGroup

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup

  • Last updated on