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

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

  • Статья

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

Синтаксис

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

Параметры

[in] engineHandle

Тип: HANDLE

Дескриптор открытого сеанса в обработчике фильтров. Вызовите FwpmEngineOpen0 , чтобы открыть сеанс для подсистемы фильтрации.

[in] flags

Тип: UINT32

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

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

Флаг SA IPsec Значение
IPSEC_SA_DETAILS_UPDATE_TRAFFIC
 Обновления структуру [IPSEC_SA_DETAILS1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1).
IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION
 Обновления структуру [IPSEC_SA_DETAILS1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1).
IPSEC_SA_BUNDLE_UPDATE_FLAGS
 Обновления структуру [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT
 Обновления структуру [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE
 Обновления структуру [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS
 Обновления структуру [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).
IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID
 Обновления структуру [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1).

[in] newValues

Тип: IPSEC_SA_CONTEXT1*

Пара SA для входящего и исходящего трафика.

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

Тип: DWORD

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

Комментарии

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

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header fwpmu.h
Библиотека Fwpuclnt.lib
DLL Fwpuclnt.dll

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

IPSEC_SA_CONTEXT1