共用方式為

INetFwPolicy2：：get_IsRuleGroupCurrentlyEnabled 方法 (netfw.h)

  • 發行項

get_IsRuleGroupCurrentlyEnabled 方法會決定目前配置檔是否啟用或停用指定的防火牆規則群組。

語法

HRESULT get_IsRuleGroupCurrentlyEnabled(
  [in]  BSTR         group,
  [out] VARIANT_BOOL *enabled
);

參數

[in] group

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

[out] enabled

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

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

針對 Windows 7 和更新版本，如果至少在一個作用中配置檔上啟用規則群組，此值將會設定為 true ( VARIANT_TRUE) 。

傳回值

C++

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

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

傳回碼 Description
ACCESSDENIED
 作業因許可權問題而中止。
E_INVALIDARG
 方法因為參數無效而失敗。
E_POINTER
 方法失敗，因為指標無效。
 

針對 Windows 7 和更新版本，如果多個配置檔為作用中，而且配置檔對 IsRuleGroupCurrentlyEnabled 有不同的答案，則傳回值會S_FALSE;如果配置檔對 IsRuleGroupCurrentlyEnabled 有相同的答案，則會S_TRUE傳回值。

VB

此呼叫會傳回布爾值啟用狀態，指出群組參數所識別的規則群組是否已啟用或停用。 如果此值設定為 true (VARIANT_TRUE) ，則會啟用規則群組;否則，群組會停用。

備註

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

規格需求

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

另請參閱

INetFwPolicy2

規則撰寫