共用方式為


INetFwAuthorizedApplications::Add 方法 (netfw.h)

[Windows 防火牆 API 可用於需求一節中指定的操作系統。 它在後續版本中可能會變更或無法使用。 針對 Windows Vista 和更新版本,建議使用 具有進階安全性 API 的 Windows 防火牆 。]

Add 方法會將新的應用程式新增至集合。

語法

HRESULT Add(
  [in] INetFwAuthorizedApplication *app
);

參數

[in] app

C++ 透過 INetFWAuthorizedApplication 物件新增至集合的應用程式。
VB 透過 INetFWAuthorizedApplication 物件新增至集合的應用程式。

傳回值

C++

如果方法成功,則會S_OK傳回值。

如果方法失敗,傳回值就是下列其中一個錯誤碼。

傳回碼 Description
E_ACCESSDENIED
作業因許可權問題而中止。
E_INVALIDARG
方法失敗,因為參數無效。
E_OUTOFMEMORY
方法無法配置必要的記憶體。
E_UNEXPECTED
方法失敗,因為對象已經在集合中。
 

VB

如果方法成功,則會S_OK傳回值。

如果方法失敗,傳回值就是下列其中一個錯誤碼。

傳回碼 Description
E_ACCESSDENIED
作業因許可權問題而中止。
E_INVALIDARG
方法失敗,因為參數無效。
E_OUTOFMEMORY
方法無法配置必要的記憶體。
E_UNEXPECTED
方法失敗,因為對象已經在集合中。

備註

如果具有相同路徑的應用程式已經存在,則會覆寫現有的設定。

規格需求

需求
最低支援的用戶端 Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 netfw.h
Dll FirewallAPI.dll;使用SP2在 Windows XP 上 Hnetcfg.dll

另請參閱

INetFWAuthorizedApplication

INetFwAuthorizedApplications