FWPS_BIND_REQUEST0 结构 (fwpsk.h)

项目
02/29/2024

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

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

portReservationToken

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

previousVersion

绑定请求数据的早期版本。此只读字段记录绑定请求的修改历史记录。此成员是使用指向单向链接列表的指针预初始化的，该列表的索引设置为当前FWPS_BIND_REQUEST0数据的记录。

modifierFilterId

分类Fn 函数的筛选器参数的 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 值的节点。