通过

IPsecSaContextUpdate0 函数 (fwpmu.h)

  • 项目

IPsecSaContextUpdate0 函数 (SA) 上下文更新 IPsec 安全关联。

语法

DWORD IPsecSaContextUpdate0(
  [in] HANDLE                  engineHandle,
  [in] UINT64                  flags,
  [in] const IPSEC_SA_CONTEXT1 *newValues
);

参数

[in] engineHandle

类型： 句柄

筛选器引擎的打开会话的句柄。 调用 FwpmEngineOpen0 以打开与筛选器引擎的会话。

[in] flags

类型： UINT32

指示正在更新 IPSEC_SA_CONTEXT1 结构中的特定字段的标志。

可能的值：

IPsec SA 标志 含义
IPSEC_SA_DETAILS_UPDATE_TRAFFIC
 汇报 [IPSEC_SA_DETAILS1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1) 结构。
IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION
 汇报 [IPSEC_SA_DETAILS1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1) 结构。
IPSEC_SA_BUNDLE_UPDATE_FLAGS
 汇报 [IPSEC_SA_BUNDLE1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 结构。
IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT
 汇报 [IPSEC_SA_BUNDLE1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 结构。
IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE
 汇报 [IPSEC_SA_BUNDLE1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 结构。
IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS
 汇报 [IPSEC_SA_BUNDLE1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 结构。
IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID
 汇报 [IPSEC_SA_BUNDLE1] (/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 结构。

[in] newValues

类型： IPSEC_SA_CONTEXT1*

入站和出站 SA 对。

返回值

类型：DWORD

返回代码/值 说明
ERROR_SUCCESS
0
 已成功更新 IPsec SA 上下文。
FWP_E_* 错误代码
0x80320001 — 0x80320039
 Windows 筛选平台 (WFP) 特定错误。 有关详细信息 ，请参阅 WFP 错误代码 。
RPC_* 错误代码
0x80010001 — 0x80010122
 无法与远程或本地防火墙引擎通信。

备注

IPsecSaContextUpdate0 是 IPsecSaContextUpdate 的特定实现。 有关详细信息 ，请参阅 WFP Version-Independent 名称和面向 Windows 的特定版本 。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 fwpmu.h
Library Fwpuclnt.lib
DLL Fwpuclnt.dll

请参阅

IPSEC_SA_CONTEXT1