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

Функция IPsecSaContextUpdate0 (fwpmk.h)

  • Статья

Функция IPsecSaContextUpdate0 обновляет контекст связи безопасности IPsec (SA).

Синтаксис

NTSTATUS IPsecSaContextUpdate0(
  [in] HANDLE                  engineHandle,
  [in] UINT64                  flags,
  [in] const IPSEC_SA_CONTEXT1 *newValues
);

Параметры

[in] engineHandle

Обработка открытого сеанса в обработчике фильтров. Вызовите FwpmEngineOpen0, чтобы открыть сеанс в обработчике фильтров.

[in] flags

Флаги, указывающие конкретное поле в обновляемой структуре IPSEC_SA_CONTEXT1.

Возможные значения:

Флаг SA IPsec Значение
IPSEC_SA_DETAILS_UPDATE_TRAFFIC Обновляет структуру IPSEC_SA_DETAILS1.
IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION Обновляет структуру IPSEC_SA_DETAILS1.
IPSEC_SA_BUNDLE_UPDATE_FLAGS Обновляет структуру IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT Обновляет структуру IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE Обновляет структуру IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS Обновляет структуру IPSEC_SA_BUNDLE1.
IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID Обновляет структуру IPSEC_SA_BUNDLE1.

[in] newValues

Пара входящих и исходящих SA.

Возвращаемое значение

Возврат кода или значения Описание
ERROR_SUCCESS
0		 Контекст SA IPsec был успешно обновлен.
FWP_E_* код ошибки
0x80320001 — 0x80320039		 Конкретная ошибка платформы фильтрации Windows (МПП). Дополнительные сведения см. в кодов ошибок МПП.
код ошибки RPC_*
0x80010001 — 0x80010122		 Не удаляйте связь с подсистемой удаленного или локального брандмауэра.
другие коды NTSTATUS Произошла ошибка.

Замечания

IPsecSaContextUpdate0 — это конкретная реализация IPsecSaContextUpdate. Дополнительные сведения см. в статье МПП Version-Independent имен и целевых версий Windows.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно начиная с Windows Vista.
целевая платформа Всеобщий
заголовка fwpmk.h
библиотеки fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

См. также