This topic has not yet been rated - Rate this topic

IPsecSaContextAddOutbound1 function

The IPsecSaContextAddOutbound1 function adds an outbound IPsec security association (SA) bundle to an existing SA context.

Note IPsecSaContextAddOutbound1 is the specific implementation of IPsecSaContextAddOutbound used in Windows 7 and later. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. For Windows Vista, IPsecSaContextAddOutbound0 is available.


DWORD IPsecSaContextAddOutbound1(
  _In_  HANDLE engineHandle,
  _In_  UINT64 id,
  _In_  const IPSEC_SA_BUNDLE1 *outboundBundle
);

engineHandle [in]

Type: HANDLE

Handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.

id [in]

Type: UINT64

Identifier for the existing IPsec SA context. This is the value returned in the id parameter by the call to IPsecSaContextCreate1.

outboundBundle [in]

Type: const IPSEC_SA_BUNDLE1*

The outbound IPsec SA bundle to be added to the SA context.

Type: DWORD

Return code/value	Description
ERROR_SUCCESS 0	The IPsec SA bundle was successfully added to the SA context.
*FWP_E_ error code** 0x80320001—0x80320039	A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details.
*RPC_ error code** 0x80010001—0x80010122	Failure to communicate with the remote or local firewall engine.

Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Header	Fwpmu.h
Library	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Community Additions