FwpsClassifyOptionSet0 関数 (fwpsk.h)

[アーティクル]
02/26/2024

FwpsClassifyOptionSet0 関数は、吹き出しフィルターの classifyFn 関数によって呼び出され、許可されるフィルター処理操作の特性に影響する追加情報を指定します。

メモFwpsClassifyOptionSet0 は、 FwpsClassifyOptionSet の特定のバージョンです。詳細については、「 WFP 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

newValue パラメーターがユニキャスト、マルチキャスト、または疎ソースマッピングの状態を参照するか、データタイムアウト値を参照するかを示すFWP_CLASSIFY_OPTION_TYPE列挙定数。詳細については、「解説」を参照してください。

[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定数値の 1 つが含まれていません。
STATUS_OBJECT_TYPE_MISMATCH	newValue -> Type で指定されたデータ型がFWP_UINT32されませんでした。
STATUS_UNSUCCESSFUL	一般的なエラーが発生しました。
その他の状態コード	エラーが発生しました。

解説

この関数は、吹き出しフィルターの classifyFn 関数によってのみ呼び出す必要があります。

次に示すオプション パラメーターの値と、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 以降で使用できます。
対象プラットフォーム	ユニバーサル
Header	fwpsk.h (Fwpsk.h を含む)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL