FWPS_BIND_REQUEST0结构（fwpsk.h）

项目
02/07/2025

FWPS_BIND_REQUEST0 结构定义FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V4和FWPM_LAYER_ALE_AUTH_BIND_REDIRECT_V6层的可修改数据。标注驱动程序使用此数据来检查或修改连接信息。

注释FWPS_BIND_REQUEST0 是特定版本的 FWPS_BIND_REQUEST。有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。

语法

typedef struct _FWPS_BIND_REQUEST0 {
  SOCKADDR_STORAGE           localAddressAndPort;
  UINT64                     portReservationToken;
  struct _FWPS_BIND_REQUEST0 *previousVersion;
  UINT64                     modifierFilterId;
} FWPS_BIND_REQUEST0;

成员

localAddressAndPort

绑定请求的本地传输地址。这是一个 IPV4 或 IPV6 地址和格式化为 SOCKADDR_STORAGE 结构的 TCP/UDP 端口。

portReservationToken

用于保留相应端口的令牌。通过调用 CreatePersistentTcpPortReservation 或 CreatePersistentUdpPortReservation来保留端口时，将获取令牌。这两个预留函数都可以在 iphlpapi.h 中找到。

previousVersion

绑定请求数据的以前版本。此只读字段记录绑定请求的修改历史记录。此成员已预先初始化，其中包含指向一个单向链接列表的指针，该列表的索引设置为当前FWPS_BIND_REQUEST0数据的记录。

modifierFilterId

函数的 筛选器 参数的 FilterId 成员的值。有关 FilterId 成员的详细信息，请参阅 FWPS_FILTER1。

言论

标注驱动程序通过调用来获取此结构 FwpsAcquireWritableLayerDataPointer0 函数，该函数通过 writableLayerData 参数返回指向 FWPS_BIND_REQUEST0 结构的指针。

分类Fn 函数可以修改绑定请求的参数，例如将本地传输地址或端口重定向到另一个地址或端口。如果修改绑定请求的参数，则为
classifyFn 函数必须执行以下作：

对 FwpsAcquireWritableLayerDataPointer0返回的 FWPS_BIND_REQUEST0 结构进行所有更改。只能修改 localAddressAndPort 和 portReservationToken 成员。
叫 FwpsApplyModifiedLayerData0，modifiedLayerData 参数设置为 FWPS_BIND_REQUEST0 结构的地址，即使标注驱动程序未修改任何数据。此值必须与 modifiedLayerData 返回的参数值相同 FwpsAcquireWritableLayerDataPointer0。

此结构充当链接列表，其中包含其他标注驱动程序所做的所有更改的记录。如果 previousVersion 成员未 NULL，则存在以前的版本信息。若要检查完整的版本历史记录，标注驱动程序必须继续检查列表中每个结构的 previousVersion 成员，直到找到一个节点，该节点已将此成员设置为 null 的值。