FwpsClassifyOptionSet0 函式 (fwpsk.h)

發行項
02/29/2024

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 代碼。

傳回碼	Description
STATUS_SUCCESS	語言函式已順利完成。
STATUS_FWP_INVALID_ENUMERATOR	option 參數與中的任何值不符 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 函式呼叫。

以下是 option 參數的允許值，以及 newValue 參數所指向之FWP_VALUE0結構的成員。

選項參數	newValue->類型 Value	newValue->uint32 Value
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 開始提供。
目標平台	Universal
標頭	fwpsk.h (包含 Fwpsk.h)
程式庫	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL