通过

iPsecKeyManagerAddAndRegister0 函数 (fwpmu.h)

  • 项目

IPsecKeyManagerAddAndRegister0 函数使用 IPsec 注册受信任的中介代理 (TIA) 。

语法

DWORD IPsecKeyManagerAddAndRegister0(
  [in]  HANDLE                             engineHandle,
  [in]  const IPSEC_KEY_MANAGER0           *keyManager,
  [in]  const IPSEC_KEY_MANAGER_CALLBACKS0 *keyManagerCallbacks,
  [out] HANDLE                             *keyMgmtHandle
);

参数

[in] engineHandle

类型： HANDLE

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

[in] keyManager

类型： const IPSEC_KEY_MANAGER0*

IPsec 将调用的密钥管理回调集。

[in] keyManagerCallbacks

类型： const IPSEC_KEY_MANAGER_CALLBACKS0*

IPsec 应在 SA 协商的各个阶段调用的回调集。

[out] keyMgmtHandle

类型： HANDLE*

新创建的注册的地址。

返回值

类型：DWORD

返回代码/值 说明
ERROR_SUCCESS
0
 TIA 已成功注册。
FWP_E_* 错误代码
0x80320001— 0x80320039
 Windows 筛选平台 (WFP) 特定错误。 有关详细信息 ，请参阅 WFP 错误代码 。
RPC_* 错误代码
0x80010001 — 0x80010122
 无法与远程或本地防火墙引擎通信。
FWP_E_ALREADY_EXISTS
0x80320009L
 TIA 未成功注册，因为已注册另一个 TIA 来听写密钥。
FWP_E_INVALID_INTERVAL
0x80320021L
 TIA 未成功注册，因为 keyDictationTimeoutHint 超出了允许的最大值 10 秒。
SEC_E_CANNOT_INSTALL
0x80090307L
 未成功注册 TIA，因为二进制映像未设置 IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY 属性。

注解

如果为 keyManager 设置了IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY标志，则必须指定 keyManagerCallbacks 的所有三个回调成员;否则，应仅指定 keyNotify 回调

不能从事务中调用此函数。 它将失败并 FWP_E_TXN_IN_PROGRESS。 有关事务的详细信息，请参阅 对象管理 。

要求

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

另请参阅

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

WFP 函数