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