FwpsClassifyOptionSet0 函数 (fwpsk.h)

项目
08/07/2023

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

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 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)
Library	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL