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 |