次の方法で共有

FwpsClassifyOptionSet0 関数 (fwpsk.h)

  • [アーティクル]

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 以降で使用できます。
ターゲット プラットフォーム の 万国
ヘッダー fwpsk.h (Fwpsk.h を含む)
ライブラリ Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

関連項目

FWPM_CLASSIFY_OPTION0

FWPM_CLASSIFY_OPTIONS0

FWPS_INCOMING_METADATA_VALUES0

FWP_CLASSIFY_OPTION_TYPE

FWP_VALUE0

classifyFn