INetFwRules::add method (netfw.h)

Add 方法将新规则添加到集合。

语法

HRESULT Add(
  [in] INetFwRule *rule
);

参数

[in] rule

要通过 INetFwRule 对象添加到集合的规则。

返回值

C++

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

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

返回代码 说明
E_ACCESSDENIED
由于权限问题,操作已中止。
E_INVALIDARG
方法失败,因为参数无效。
E_UNEXPECTED
方法失败,因为 对象已在集合中。
 

VB

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

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

返回代码 说明
E_ACCESSDENIED
由于权限问题,操作已中止。
E_INVALIDARG
方法失败,因为参数无效。
E_UNEXPECTED
方法失败,因为 对象已在集合中。

注解

如果规则标识符与提交的规则标识符相同的规则已存在,则会覆盖现有规则。

添加指定了 LocalAppPackageId 的防火墙规则可能会导致意外行为,因此不受支持。

要求

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

另请参阅

INetFwRule

INetFwRules