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
);

parameters

[in] UrlGroupId

为其设置了 属性的 URL 组的 ID。

[in] Property

描述修改或设置的属性类型的 HTTP_SERVER_PROPERTY 枚举的成员。 可以是以下位置之一：

属性 含义
HttpServerAuthenticationProperty
 使用基本、NTLM、协商和摘要身份验证方案为 URL 组启用服务器端身份验证。
HttpServerExtendedAuthenticationProperty
 使用 Kerberos 身份验证方案为 URL 组启用服务器端身份验证。
HttpServerQosProperty
 此值映射到 QosType 设置为 HttpQosSettingTypeBandwidth 或 HttpQosSettingTypeConnectionLimit 的泛型HTTP_QOS_SETTING_INFO结构。 如果 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
 URL 组不支持 Property 参数中指定的 属性 类型。

pPropertyInformation 参数为 NULL。

PropertyInformationLength 参数为零。

UrlGroupId 参数不包含有效的服务器会话。

应用程序没有设置 URL 组属性的权限。 只有创建 URL 组的应用程序才能设置属性。

注解

创建 URL 组后，它必须与请求队列关联才能接收请求。 若要将 URL 组与请求队列关联，应用程序使用 HttpServerBindingProperty 属性调用 HttpSetUrlGroupProperty。 如果未设置此属性，则不会将 URL 组的匹配请求传递到请求队列，并且 HTTP 服务器 API 将生成 503 响应。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 http.h
Library Httpapi.lib
DLL Httpapi.dll

另请参阅

HTTP 服务器 API 版本 2.0 函数

HttpAddUrlToUrlGroup

HttpCloseUrlGroup

HttpCreateUrlGroup

HttpQueryUrlGroupProperty

HttpRemoveUrlFromUrlGroup