共用方式為

INetFwPolicy2：：EnableRuleGroup 方法 (netfw.h)

  • 發行項

EnableRuleGroup 方法會啟用或停用指定的防火牆規則群組。

語法

HRESULT EnableRuleGroup(
  [in] long         profileTypesBitmask,
  [in] BSTR         group,
  [in] VARIANT_BOOL enable
);

參數

[in] profileTypesBitmask

來自 NET_FW_PROFILE_TYPE2 的配置檔位掩碼。

[in] group

用來將規則分組在一起的字串。 它可以是組名或群組名稱的間接字串，格式為 “@C：\Program Files\Contoso Storefront\StorefrontRes.dll，-1234”。 屬於此群組的規則將會啟用或停用。

[in] enable

指出要啟用或停用 群組 參數所識別的規則群組。

如果此值設定為 true (VARIANT_TRUE) ，則會啟用規則群組;否則，群組會停用。

傳回值

C++

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

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

傳回碼 Description
E_ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法因為參數無效而失敗。
S_FALSE
 要求的群組不存在。
 

VB

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

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

傳回碼 Description
E_ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法因為參數無效而失敗。
S_FALSE
 要求的群組不存在。

備註

當 「@C：\Program Files\Contoso Storefront\StorefrontRes.dll，-1234」 形式的間接字串當做參數傳遞至具有進階安全性 API 的 Windows 防火牆時，它們應該由完整路徑指定。 檔案應具有安全存取權，允許本機服務帳戶讀取許可權，以允許 Windows 防火牆服務讀取字串。 為了避免非特殊許可權的安全性主體修改字串，DLL 應該只允許系統管理員帳戶的寫入許可權。

規格需求

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

另請參閱

INetFwPolicy2

規則撰寫