IPSEC_OFFLOAD_V2_ADD_SA 结构 (ndis.h)
[IPsec 任务卸载功能已弃用，不应使用。]
IPSEC_OFFLOAD_V2_ADD_SA 结构定义有关微型端口驱动程序应添加到 NIC 的安全关联 (SA) 的信息。
语法
typedef struct _IPSEC_OFFLOAD_V2_ADD_SA {
NDIS_OBJECT_HEADER Header;
PIPSEC_OFFLOAD_V2_ADD_SA Next;
ULONG NumExtHdrs;
ULONG Flags;
union {
struct {
IPAddr SrcAddr;
IPAddr DestAddr;
} IPv4Endpoints;
struct {
UCHAR SrcAddr[16];
UCHAR DestAddr[16];
} IPv6Endpoints;
};
NDIS_HANDLE OffloadHandle;
ULONG UdpEspEncapsulation;
IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION SecAssoc[IPSEC_OFFLOAD_V2_MAX_EXTENSION_HEADERS];
ULONG KeyLength;
UCHAR KeyData[1];
} IPSEC_OFFLOAD_V2_ADD_SA, *PIPSEC_OFFLOAD_V2_ADD_SA;
成员
Header
IPSEC_OFFLOAD_V2_ADD_SA 结构的NDIS_OBJECT_HEADER结构。 将 Header 指定的结构的 Type 成员设置为NDIS_OBJECT_TYPE_DEFAULT，将 Revision 成员设置为NDIS_IPSEC_OFFLOAD_V2_ADD_SA_REVISION_1，并将 Size 成员设置为NDIS_SIZEOF_IPSEC_OFFLOAD_V2_ADD_SA_REVISION_1。
Next
指向IPSEC_OFFLOAD_V2_ADD_SA结构的指针，该结构是链接列表中的下一个结构。 如果指针为 NULL，则当前结构是列表中的最后一个结构。
NumExtHdrs
IPsec 扩展标头的数目。 此成员可以是以下值之一。
| 安全类型 | 扩展标头 |
|---|---|
| 仅限 AH 身份验证 | 1 |
| 仅 ESP 身份验证 | 1 |
| 仅 ESP 加密 | 1 |
| ESP 身份验证和加密 | 1 |
| AH 加 ESP 身份验证和加密 | 2 |
| UDP ESP | 1 |
Flags
一个位掩码，指示要添加的 SA 是入站 SA 还是出站 SA，如下所示：
IPSEC_OFFLOAD_V2_IPv6
如果设置了此标志，则地址为 IPv6。 否则，地址为 IPv4
IPSEC_OFFLOAD_V2_INBOUND
如果设置了此标志，则 SA 为入站。 否则，SA 是出站的。
IPv4Endpoints
IPv4 终结点地址。 此结构包含以下成员：
IPv4Endpoints.SrcAddr
源主机的 IPv4 地址 () 发送数据包的主机。
IPv4Endpoints.DestAddr
目标主机的 IPv4 地址 (接收数据包) 主机。
IPv6Endpoints
IPv6 终结点地址。 此结构包含以下成员：
IPv6Endpoints.SrcAddr[16]
源主机的 IPv6 地址 () 发送数据包的主机。
IPv6Endpoints.DestAddr[16]
接收数据包) 的主机 (目标主机的 IPv6 地址。
OffloadHandle
新创建的 SA 的句柄。 微型端口驱动程序在完成之前提供此句柄
OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA 请求。 TCP/IP 传输必须在
NDIS_IPSEC_OFFLOAD_V2_NET_BUFFER_LIST_INFO 或 在 将发送数据包传递到微型端口驱动程序之前，NDIS_IPSEC_OFFLOAD_V2_TUNNEL_NET_BUFFER_LIST_INFO结构。 使用 删除 SA 时，TCP/IP 传输还必须指定此句柄 OID_TCP_TASK_IPSEC_OFFLOAD_V2_DELETE_SA 请求。
UdpEspEncapsulation
UDP ESP 封装类型。 此成员可以是以下一个或多个标志：
IPSEC_OFFLOAD_V2_UDP_ESP_ENCAPSULATION_NONE
不使用 UDP 封装。
IPSEC_OFFLOAD_V2_UDP_ESP_ENCAPSULATION_TRANSPORT
ESP 封装的传输模式数据包由 UDP 封装。
IPSEC_OFFLOAD_V2_UDP_ESP_ENCAPSULATION_TUNNEL
数据包的隧道模式部分采用 UDP 封装。 数据包的传输模式部分不是 UDP 封装的，并且不受 ESP 保护。
IPSEC_OFFLOAD_V2_TRANSPORT_OVER_UDP_ESP_ENCAPSULATION_TUNNEL
数据包的隧道模式部分采用 UDP 封装。 数据包的传输模式部分不是 UDP 封装的，而是受 ESP 保护的。
IPSEC_OFFLOAD_V2_UDP_ESP_ENCAPSULATION_TRANSPORT_OVER_TUNNEL
数据包的隧道模式部分不是 UDP 封装的。 数据包的传输模式部分采用 UDP 封装且受 ESP 保护。
SecAssoc[IPSEC_OFFLOAD_V2_MAX_EXTENSION_HEADERS]
包含两个元素的数组，其中包含有关 SA (AH、ESP 或两者) 的 IPsec 操作的信息。 提供的元素数在 NumExtHdrs 成员中指定。 每个 IPsec 操作的信息的格式设置为 IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION 结构，如下所述。
TCP/IP 传输在 SecAssoc 处的缓冲区中指定一个或两个IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION结构。 每个IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION结构都指示使用结构中指定的 SA 的操作类型（身份验证或加密/解密）。 数组中IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION结构的顺序指示微型端口驱动程序应为每个 SA 执行操作的顺序。 仅支持一种操作组合：加密/解密 (ESP) 后跟身份验证 (AH) 。
KeyLength
KeyData 处缓冲区的长度（以字节为单位）。
KeyData[1]
一个可变长度数组，其中包含 在 SecAssoc 中指定的 SA 的键。 如果加密算法和身份验证算法都由 的 EncryptionAlgorithm 和 AuthenticationAlgorithm 成员指定 IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION 结构中， KeyData 上的缓冲区包含一个密钥信息，后跟另一个密钥信息。 键的开头和长度分别由 KeyOffsetBytes 和 KeyLength 成员指定。
注解
此结构已过时，请改用 IPSEC_OFFLOAD_V2_ADD_SA_EX 。
IPSEC_OFFLOAD_V2_ADD_SA 结构指定应添加的安全 SA，以及指向链接列表中的下一个IPSEC_OFFLOAD_V2_ADD_SA结构的指针。 IPSEC_OFFLOAD_V2_ADD_SA 结构与 OID_TCP_TASK_IPSEC_OFFLOAD_V2_ADD_SA 老。
IPSEC_OFFLOAD_V2_ADD_SA结构指定了源和目标，以及应用了 SA 的 IP 协议。 此筛选器适用于传输模式连接，即两个主机之间的端到端连接。 如果指定的连接是通过隧道建立的，则指定隧道的源地址和目标地址。
如果成员设置为零，则不使用该参数来筛选指定 SA 的数据包。 例如，如果 SrcAddr 设置为零，则指定的 SA 可以应用于包含任何源地址的数据包。 如果所有筛选器参数都设置为零，则指定的 SA 将应用于向任何目标主机发送任何类型的数据包的任何源主机。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 NDIS 6.1 和 6.20 中受支持。 对于 NDIS 6.30 及更高版本，请使用 IPSEC_OFFLOAD_V2_ADD_SA_EX。 |
| 标头 | ndis.h (包括 Ndis.h) |