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 |
---|---|
|
已成功註冊 TIA。 |
|
Windows 篩選平臺 () 特定錯誤。 如需詳細資訊,請參閱 其錯誤碼 。 |
|
無法與遠端或本機防火牆引擎通訊。 |
|
TIA 未成功註冊,因為已經註冊另一個 TIA 來指定金鑰。 |
|
TIA 未成功註冊,因為 keyDictationTimeoutHint 超過允許的最大值10秒。 |
|
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 |