Share via


FwpmIPsecTunnelDeleteByKey0 (Compact 7)

3/12/2014

This function removes an IPsec tunnel mode policy from the system.

Syntax

DWORD WINAPI FwpmIPsecTunnelDeleteByKey0(
  __in  HANDLE engineHandle,
  __in  const GUID* key
);

Parameters

  • engineHandle
    A handle for an open session to the filter engine. Call FwpmEngineOpen0 to open a session to the filter engine.
  • key
    A pointer to the GUID that uniquely identifies the IPsec tunnel. This GUID was specified in the providerContextKey member of the tunnelPolicy parameter of the FwpmIPsecTunnelAdd0 function.

Return Value

Return code / value Description

ERROR_SUCCESS

0

The IPsec tunnel mode policy was successfully deleted.

FWP_E_* error code

0x80320001-0x80320039

A Windows Filtering Platform (WFP) specific error. See topic WFP Error Codes for details.

RPC_* error code

0x80010001-0x80010122

Failure to communicate with the remote or local firewall engine.

Remarks

This function cannot be called from within a read-only transaction. It will fail with FWP_E_INCOMPATIBLE_TXN.

Requirements

Header

fwpmu.h

Library

fwpuclnt.dll

See Also

Reference

WFP IPsec Functions

Other Resources

Windows Filtering Platform