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

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

  • Статья

Функция 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

Функции МПП