IPSEC_OFFLOAD_V2_ADD_SA結構（ndis.h）
[IPsec 工作卸除功能已被取代，不應使用。]
IPSEC_OFFLOAD_V2_ADD_SA 結構會定義迷你埠驅動程序應該新增至 NIC 之安全性關聯的相關信息。
語法
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 指定為NDIS_OBJECT_TYPE_DEFAULT的 Type 成員、將 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，如下所示：
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之IPsec作業的相關信息（AH、ESP或兩者）。 提供的元素數目是在 NumExtHdrs 成員中指定。 每個 IPsec 作業的資訊會格式化為 IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION 結構，如下所述。
TCP/IP 傳輸會在 SecAssoc 指定緩衝區中的一或兩個IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION結構。 每個IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION結構都會指出要使用 結構中所指定 SA 的 operation--authentication 或 encryption/decryption-類型。 陣列中IPSEC_OFFLOAD_V2_SECURITY_ASSOCIATION結構的順序表示迷你埠驅動程序應該針對每個 SA 執行作業的順序。 只支援一個作業組合：加密/解密（ESP）後面接著驗證（AH）。
KeyLength
KeyData 的緩衝區長度，以位元組為單位， 。
KeyData[1]
可變長度陣列，包含指定於 SecAssoc 之 SAS 的索引鍵。 如果加密演算法和驗證演算法都由 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 OID。
IPSEC_OFFLOAD_V2_ADD_SA 結構會指定套用 CA 的來源和目的地，以及 IP 通訊協定。 此篩選條件與傳輸模式連線有關，也就是兩部主機之間的端對端連線。 如果透過通道建立指定的連接，則會指定通道的來源和目的地位址。
如果成員設定為零，該參數不會用來篩選指定 SA 的封包。 例如，如果 SrcAddr 設定為零，則指定的 SAS 可以套用至包含任何來源位址的封包。 如果所有篩選參數都設定為零，則指定的 SA 會套用至任何將任何類型的封包傳送至任何目的地主機的來源主機。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | NDIS 6.1 和 6.20 支援。 針對 NDIS 6.30 和更新版本，請使用 IPSEC_OFFLOAD_V2_ADD_SA_EX。 |
| 標頭 | ndis.h （包括 Ndis.h） |