INetFwRules：：Add 方法 (netfw.h)

  • 發行項

Add 方法會將新的規則新增至集合。

語法

HRESULT Add(
  [in] INetFwRule *rule
);

參數

[in] rule

要透過 INetFwRule 物件新增至集合的規則。

傳回值

C++

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

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

傳回碼 Description
E_ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法失敗，因為參數無效。
E_UNEXPECTED
 方法失敗，因為對象已經在集合中。
 

VB

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

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

傳回碼 Description
E_ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法失敗，因為參數無效。
E_UNEXPECTED
 方法失敗，因為對象已經在集合中。

備註

如果具有與提交規則標識符相同的規則已經存在，則會覆寫現有的規則。

使用指定的 LocalAppPackageId 新增防火牆規則可能會導致非預期的行為，而且不受支援。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 netfw.h
Dll FirewallAPI.dll

另請參閱

INetFwRule

INetFwRules