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

傳回碼/值 Description
ERROR_SUCCESS
0
 已成功註冊 TIA。
FWP_E_* 錯誤碼
0x80320001— 0x80320039
 Windows 篩選平臺 () 特定錯誤。 如需詳細資訊，請參閱 其錯誤碼 。
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
程式庫 Fwpuclnt.lib
Dll Fwpuclnt.dll

另請參閱

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

WFP 函式