通过

INetFwPolicy2：：EnableRuleGroup 方法 (netfw.h)

EnableRuleGroup 方法启用或禁用一组指定的防火墙规则。

语法

HRESULT EnableRuleGroup(
  [in] long         profileTypesBitmask,
  [in] BSTR         group,
  [in] VARIANT_BOOL enable
);

参数

[in] profileTypesBitmask

NET_FW_PROFILE_TYPE2配置文件的位掩码。

[in] group

用于将规则组合在一起的字符串。 它可以是组名称，也可以是组名称的间接字符串，格式为“@C：\Program Files\Contoso Storefront\StorefrontRes.dll，-1234”。 将启用或禁用属于此组的规则。

[in] enable

指示是启用还是禁用 由组 参数标识的规则组。

如果此值设置为 true (VARIANT_TRUE) ，则将启用规则组;否则，将禁用组。

返回值

C++

如果该方法成功，则返回值S_OK。

如果方法失败，则返回值为以下错误代码之一。

返回代码 说明
E_ACCESSDENIED
 由于权限问题，操作已中止。
E_INVALIDARG
 由于参数无效，方法失败。
S_FALSE
 请求的组不存在。
 

VB

如果该方法成功，则返回值S_OK。

如果方法失败，则返回值为以下错误代码之一。

返回代码 说明
E_ACCESSDENIED
 由于权限问题，操作已中止。
E_INVALIDARG
 由于参数无效，方法失败。
S_FALSE
 请求的组不存在。

注解

将“@C：\Program Files\Contoso Storefront\StorefrontRes.dll，-1234”形式的间接字符串作为参数传递给具有高级安全 API 的 Windows 防火墙时，它们应由完整路径指定。 该文件应具有允许本地服务帐户读取访问权限的安全访问，以允许 Windows 防火墙服务读取字符串。 为了避免非特权安全主体修改字符串，DLL 应仅允许对管理员帐户进行写入访问。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 netfw.h
DLL FirewallAPI.dll

另请参阅

INetFwPolicy2

规则创作

  • Last updated on