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

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

  • Статья

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

Синтаксис

NTSTATUS IPsecSaContextCreate0(
  [in]            HANDLE               engineHandle,
  [in]            const IPSEC_TRAFFIC0 *outboundTraffic,
  [out, optional] UINT64               *inboundFilterId,
  [out]           UINT64               *id
);

Параметры

[in] engineHandle

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

[in] outboundTraffic

Исходящий трафик SA.

[out, optional] inboundFilterId

Необязательный идентификатор фильтра кэшированного входящего трафика, соответствующий параметру outboundTraffic, указанному вызывающим элементом. Базовый модуль фильтрации (BFE) может кэшировать идентификатор входящего фильтра и возвращать кэшированное значение, если оно доступно. Вызывающий объект должен обрабатывать случай, если BFE не имеет кэшированного значения, в этом случае этот параметр будет иметь значение 0.

[out] id

Идентификатор контекста SA IPsec.

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

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

Замечания

Эта функция не может вызываться из транзакции, она завершается ошибкой с FWP_E_TXN_IN_PROGRESS. Дополнительные сведения о транзакциях см. в управления объектами.

Эту функцию нельзя вызвать из динамического сеанса. Вызов завершается ошибкой с FWP_E_DYNAMIC_SESSION_IN_PROGRESS. Дополнительные сведения о динамических сеансах см. в управления объектами.

Вызывающий объект должен FWPM_ACTRL_ADD доступ к базе данных связей безопасности IPsec. Дополнительные сведения см. в управления доступом.

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

Требования

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

См. также