INetFwRules::add method (netfw.h)
Add 方法将新规则添加到集合。
语法
HRESULT Add(
[in] INetFwRule *rule
);
参数
[in] rule
要通过 INetFwRule 对象添加到集合的规则。
返回值
C++
如果该方法成功,则返回值S_OK。如果方法失败,则返回值为以下错误代码之一。
返回代码 | 说明 |
---|---|
|
由于权限问题,操作已中止。 |
|
方法失败,因为参数无效。 |
|
方法失败,因为 对象已在集合中。 |
VB
如果该方法成功,则返回值S_OK。如果方法失败,则返回值为以下错误代码之一。
返回代码 | 说明 |
---|---|
|
由于权限问题,操作已中止。 |
|
方法失败,因为参数无效。 |
|
方法失败,因为 对象已在集合中。 |
注解
如果规则标识符与提交的规则标识符相同的规则已存在,则会覆盖现有规则。
添加指定了 LocalAppPackageId 的防火墙规则可能会导致意外行为,因此不受支持。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | netfw.h |
DLL | FirewallAPI.dll |