The FwpmIPsecTunnelAdd0 function adds a new Internet Protocol Security (IPsec) tunnel mode policy to the system.
DWORD FwpmIPsecTunnelAdd0( HANDLE engineHandle, UINT32 flags, const FWPM_PROVIDER_CONTEXT0 *mainModePolicy, const FWPM_PROVIDER_CONTEXT0 *tunnelPolicy, UINT32 numFilterConditions, const FWPM_FILTER_CONDITION0 *filterConditions, PSECURITY_DESCRIPTOR sd );
A handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.
|IPsec tunnel flag||Meaning|
||Adds a point-to-point tunnel to the system.|
The Main Mode policy for the IPsec tunnel.
The Quick Mode policy for the IPsec tunnel.
Number of filter conditions present in the filterConditions parameter.
Array of filter conditions that describe the traffic which should be tunneled by IPsec.
The security information associated with the IPsec tunnel.
||The IPsec tunnel mode policy was successfully added.|
||FWPM_TUNNEL_FLAG_POINT_TO_POINT was not set and conditions other than local/remote address were specified.|
||A Windows Filtering Platform (WFP) specific error. See WFP Error Codes for details.|
||Failure to communicate with the remote or local firewall engine.|
This function cannot be called from within a read-only transaction. It will fail with FWP_E_INCOMPATIBLE_TXN. See Object Management for more information about transactions.
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2008 [desktop apps only]|