共用方式為


FwpmEngineSetOption0 函式 (fwpmu.h)

FwpmEngineSetOption0函式會變更篩選引擎設定。

語法

DWORD FwpmEngineSetOption0(
  [in] HANDLE             engineHandle,
  [in] FWPM_ENGINE_OPTION option,
  [in] const FWP_VALUE0   *newValue
);

參數

[in] engineHandle

類型: HANDLE

篩選引擎開啟會話的控制碼。 呼叫 FwpmEngineOpen0 以開啟篩選引擎的會話。

[in] option

類型: FWPM_ENGINE_OPTION

要設定的選項。

[in] newValue

類型: FWP_VALUE0*

新的選項值。 newValue參數中包含的資料類型應該FWP_UINT32

選項FWPM_ENGINE_COLLECT_NET_EVENTS時,newValue應該是下列其中一項。

意義
0
請勿收集網路事件。
1
收集網路事件。 這是預設值。
 

optionFWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS時, newValue 應該是 0 (零) 或下列值的位組合。

注意 如果 newValue 是 0,則會停用輸入多播和廣播事件的集合。 這是預設值。
 
意義
FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST
1
收集輸入多播網路事件。
FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST
2
收集輸入廣播網路事件。
 

選項FWPM_ENGINE_PACKET_QUEUING (僅適用于 Windows 8 和 Windows Server 2012) 時,newValue應該是下列其中一項。

意義
FWPM_ENGINE_OPTION_PACKET_QUEUE_NONE
0
請勿啟用封包佇列。
FWPM_ENGINE_OPTION_PACKET_QUEUE_INBOUND
1
啟用輸入封包佇列。
FWPM_ENGINE_OPTION_PACKET_QUEUE_OUTBOUND
2
啟用輸出封包佇列。
 

選項FWPM_ENGINE_MONITOR_IPSEC_CONNECTIONS (僅適用于 Windows 8 和 Windows Server 2012) 時,newValue應該是下列專案。 (FwpmEngineSetOption0可用來啟用連線,但在嘗試停用 it.) 時,會失敗並出現FWP_E_STILL_ON ERROR

意義
1
將會啟用 IPsec 連線監視功能。 系統會記錄新的 IPsec 線上活動,以及傳送的通知。
 

選項FWPM_ENGINE_TXN_WATCHDOG_TIMEOUT_IN_MSEC (僅適用于 Windows 8 和 Windows Server 2012) 時,newValue應該是以毫秒為單位的時間,以毫秒為單位,以指定單一的一個交易的持續時間上限。 花費超過此持續時間的交易將會觸發監視程式事件。

FWPM_ENGINE_NAME_CACHE選項會保留供內部使用。

傳回值

類型: DWORD

傳回碼/值 描述
ERROR_SUCCESS
0
選項已成功設定。
FWP_E_* 錯誤碼
0x80320001— 0x80320039
Windows 篩選平台 () 特定錯誤。 如需詳細資訊,請參閱 其錯誤碼
RPC_* 錯誤碼
0x80010001— 0x80010122
無法與遠端或本機防火牆引擎通訊。

備註

無法從交易內呼叫此函式。 它將會失敗 ,並FWP_E_TXN_IN_PROGRESS。 如需交易的詳細資訊,請參閱 物件管理

無法從動態會話內呼叫此函式。 它將會失敗 ,並FWP_E_DYNAMIC_SESSION_IN_PROGRESS。 如需會話的詳細資訊,請參閱 物件管理

呼叫端需要 FWPM_ACTRL_WRITE 篩選引擎的存取權。 如需詳細資訊,請參閱存取控制

網路事件集合的預設設定如下:

  • 會收集輸出、所有 (單播、多播和廣播) 事件。
  • 只會收集輸入的單播事件。
網路事件收集設定會在重新開機時保存。

若要收集輸入廣播和/或多播網路事件,

  1. 呼叫 FwpmEngineSetOption0並將選項 設定為 FWPM_ENGINE_COLLECT_NET_EVENTS ,並將 newValue 設定為 1。
  2. 呼叫FwpmEngineSetOption0,並將選項設定為 FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS,並將 newValue參數設定為 FWPM_NET_EVENT_KEYWORD_INBOUND_MCAST 和/或 FWPM_NET_EVENT_KEYWORD_INBOUND_BCAST。
若要停止收集輸入廣播和/或多播網路事件,
  • 呼叫 FwpmEngineSetOption0並將選項 設定為 FWPM_ENGINE_NET_EVENT_MATCH_ANY_KEYWORDS ,並將 newValue 參數設定為 0 (零) 。
停用和重新啟用網路事件收集 (FWPM_ENGINE_COLLECT_NET_EVENTS) 不會重設輸入廣播和多播事件的集合。

FwpmEngineSetOption0 是 FwpmEngineSetOption 的特定實作。 如需詳細資訊 ,請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 fwpmu.h
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll

另請參閱

FWPM_ENGINE_OPTION

FWP_VALUE0

FwpmEngineGetOption0