FwpsClassifyOptionSet0 函式（fwpsk.h）

發行項
02/07/2025

FwpsClassifyOptionSet0 函式是由圖說篩選器的 classifyFn 函式呼叫，以指定影響允許篩選作業特性的其他資訊。

附注FwpsClassifyOptionSet0 是 FwpsClassifyOptionSet 的特定版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

NTSTATUS FwpsClassifyOptionSet0(
  [in] const FWPS_INCOMING_METADATA_VALUES0 *inMetadataValues,
  [in] const FWP_CLASSIFY_OPTION_TYPE       option,
  [in] const FWP_VALUE0                     *newValue
);

參數

[in] inMetadataValues

FWPS_INCOMING_METADATA_VALUES0 結構的指標。此結構包含所篩選之圖層上每個元數據欄位的值。

[in] option

FWP_CLASSIFY_OPTION_TYPE 列舉常數，指出 newValue 參數是否參考單播、多播或鬆散的來源對應狀態，或數據逾時值。如需詳細資訊，請參閱。

[in] newValue

FWP_VALUE0 結構的陣列指標。數位中的每個結構都包含特定FWP_OPTION_VALUE_XXX常數的特定值。如需詳細資訊，請參閱。

傳回值

FwpsClassifyOptionSet0 函式會傳回下列其中一個 NTSTATUS 程式代碼。

傳回碼	描述
STATUS_SUCCESS	函式已順利完成。
STATUS_FWP_INVALID_ENUMERATOR	選項參數不符合中任何值 FWP_CLASSIFY_OPTION_TYPE 列舉。
STATUS_FWP_OUT_OF_BOUNDS	newValue -> uint32 所指定的選項值不包含其中一個定義的 FWP_OPTION_VALUE_XXX常數值。
STATUS_OBJECT_TYPE_MISMATCH	newValue -> Type 所指定的數據類型不是FWP_UINT32。
STATUS_UNSUCCESSFUL	發生一般錯誤。
其他狀態代碼	發生錯誤。

言論

此函式只能由圖說文字篩選器的 classifyFn 函式呼叫。

以下是 newValue 參數所指向之 FWP_VALUE0 結構參數選項的允許值。

參數選項	newValue->類型 Value	newValue->uint32 值
FWP_CLASSIFY_OPTION_LOOSE_SOURCE_MAPPING	FWP_UINT32	FWP_OPTION_VALUE_ENABLE_LOOSE_SOURCE 啟用鬆散的來源對應。 FWP_OPTION_VALUE_DISABLE_LOOSE_SOURCE 停用鬆散的來源對應。
FWP_CLASSIFY_OPTION_MULTICAST_STATE	FWP_UINT32	FWP_OPTION_VALUE_ALLOW_MULTICAST_STATE 允許在輸出流量上建立連結本機多播狀態。 FWP_OPTION_VALUE_DENY_MULTICAST_STATE 不允許在輸出流量上建立連結本機多播狀態。 FWP_OPTION_VALUE_ALLOW_NON_LINK_LOCAL_RESPONSE 允許針對輸出流量建立多播狀態（允許非連結本機回應）。
FWP_CLASSIFY_OPTION_MCAST_BCAST_LIFETIME	FWP_UINT32 > 0	指定多播/廣播狀態存留期，以秒為單位。
FWP_CLASSIFY_OPTION_UNICAST_LIFETIME	FWP_UINT32 > 0	指定單播狀態存留期，以秒為單位。

要設定特定選項的第一個（最高權數）呼叫端將會獲得該選項。例如，如果圖說文字 A 設定多播狀態選項，圖說 B 將無法這麼做，但圖說文字 B 可以設定其他選項。

要求

要求	價值
最低支援的用戶端	從 Windows Vista 開始提供。
目標平臺	普遍
標頭	fwpsk.h （包括 Fwpsk.h）
連結庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL