通过

INetFwPolicy2：：IsRuleGroupEnabled 方法 (netfw.h)

  • 项目

IsRuleGroupEnabled 方法确定是启用或禁用指定的防火墙规则组。

语法

HRESULT IsRuleGroupEnabled(
  [in]  long         profileTypesBitmask,
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

参数

[in] profileTypesBitmask

NET_FW_PROFILE_TYPE2配置文件的位掩码。

[in] group

用于将规则组合在一起的字符串。 它可以是组名称，也可以是组名称的间接字符串，格式为“@yourresourcedll.dll，-23255”。 将查询属于此组的规则。

[out] enabled

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

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

返回值

C++

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

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

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

VB

此调用返回布尔启用状态，指示是启用还是禁用组参数标识的规则组。 如果此值设置为 true (VARIANT_TRUE) ，则启用规则组;否则，将禁用组。

注解

将“@yourresourcedll.dll，-23255”形式的间接字符串作为参数传递给具有高级安全 API 的 Windows 防火墙时，它们应放置在 System32 Windows 目录下，或者由完整路径指定。 此外，该文件应具有允许本地服务帐户读取访问权限的安全访问，以允许 Windows 防火墙服务读取字符串。 为了避免非特权安全主体修改字符串，DLL 应仅允许对管理员帐户进行写入访问。

要求

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

另请参阅

INetFwPolicy2