[Windows 防火墙 API 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 对于 Windows Vista 及更高版本,建议使用 具有高级安全性 API 的 Windows 防火墙 。]
Add 方法将新应用程序添加到集合。
语法
HRESULT Add(
  [in] INetFwAuthorizedApplication *app
);
参数
[in] app
| C++ | 要通过 INetFWAuthorizedApplication 对象添加到集合的应用程序。 | 
| VB | 要通过 INetFWAuthorizedApplication 对象添加到集合的应用程序。 | 
返回值
C++
如果方法成功,则返回值为S_OK。如果方法失败,则返回值为以下错误代码之一。
| 返回代码 | 说明 | 
|---|---|
  | 
由于权限问题,操作已中止。 | 
  | 
方法失败,因为参数无效。 | 
  | 
方法无法分配所需的内存。 | 
  | 
方法失败,因为 对象已在集合中。 | 
VB
如果方法成功,则返回值为S_OK。如果方法失败,则返回值为以下错误代码之一。
| 返回代码 | 说明 | 
|---|---|
  | 
由于权限问题,操作已中止。 | 
  | 
方法失败,因为参数无效。 | 
  | 
方法无法分配所需的内存。 | 
  | 
方法失败,因为 对象已在集合中。 | 
注解
如果已存在具有相同路径的应用程序,则会覆盖现有设置。
要求
| 要求 | 值 | 
|---|---|
| 最低受支持的客户端 | Windows Vista、Windows XP 和 SP2 [仅限桌面应用] | 
| 最低受支持的服务器 | Windows Server 2003 SP1 [仅限桌面应用] | 
| 目标平台 | Windows | 
| 标头 | netfw.h | 
| DLL | FirewallAPI.dll;使用 SP2 在 Windows XP 上 Hnetcfg.dll |