Функция IPsecKeyManagerAddAndRegister0 (fwpmu.h)

Статья
08/23/2023

Функция IPsecKeyManagerAddAndRegister0 регистрирует доверенный промежуточный агент (TIA) с помощью IPsec.

Синтаксис

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). Дополнительные сведения см. в разделе Коды ошибок ВПП .
Код ошибки RPC_* 0x80010001 — 0x80010122	Сбой связи с подсистемой удаленного или локального брандмауэра.
FWP_E_ALREADY_EXISTS 0x80320009L	ТиА не была успешно зарегистрирована, так как другая тиА уже зарегистрирована для диктовки ключей.
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
Header	fwpmu.h
Библиотека	Fwpuclnt.lib
DLL	Fwpuclnt.dll

См. также раздел

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

Функции МПП

Поделиться через