IPsecSaContextUpdate0 函数 （fwpmk.h）
IPsecSaContextUpdate0 函数更新 IPsec 安全关联（SA）上下文。
语法
NTSTATUS IPsecSaContextUpdate0(
[in] HANDLE engineHandle,
[in] UINT64 flags,
[in] const IPSEC_SA_CONTEXT1 *newValues
);
参数
[in] engineHandle
筛选引擎打开的会话句柄。 调用 FwpmEngineOpen0 以打开筛选器引擎的会话。
[in] flags
指示正在更新IPSEC_SA_CONTEXT1结构中的特定字段的标志。
可能的值：
| IPsec SA 标志 | 意义 |
|---|---|
| IPSEC_SA_DETAILS_UPDATE_TRAFFIC | 更新 IPSEC_SA_DETAILS1 结构。 |
| IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION | 更新 IPSEC_SA_DETAILS1 结构。 |
| IPSEC_SA_BUNDLE_UPDATE_FLAGS | 更新 IPSEC_SA_BUNDLE1 结构。 |
| IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT | 更新 IPSEC_SA_BUNDLE1 结构。 |
| IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE | 更新 IPSEC_SA_BUNDLE1 结构。 |
| IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS | 更新 IPSEC_SA_BUNDLE1 结构。 |
| IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID | 更新 IPSEC_SA_BUNDLE1 结构。 |
[in] newValues
入站和出站 SA 对。
返回值
| 返回代码/值 | 描述 |
|---|---|
|
ERROR_SUCCESS 0 |
IPsec SA 上下文已成功更新。 |
|
FWP_E_* 错误代码 0x80320001 — 0x80320039 |
Windows 筛选平台（WFP）特定错误。 有关详细信息，请参阅 WFP 错误代码。 |
|
RPC_* 错误代码 0x80010001 — 0x80010122 |
无法与远程或本地防火墙引擎通信。 |
| 其他 NTSTATUS 代码 | 发生错误。 |
言论
IPsecSaContextUpdate0 是 IPsecSaContextUpdate的特定实现。 有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows Vista 开始可用。 |
| 目标平台 | 普遍 |
| 标头 | fwpmk.h |
| 库 | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |