IFWXFirewallAction Interface

The IFWXFirewallAction interface cancels a firewall action.

Syntax

interface IFWXFirewallAction : IUnknown

Methods

The IFWXFirewallAction interface inherits the methods of the IUnknown interface.

In addition, IFWXFirewallAction defines the following method.

Method Description

Cancel

Cancels a Microsoft Firewall service action.

Remarks

A filter may request that the Firewall service perform a firewall action, such as connecting to a certain target, based on a firewall event or address. A firewall action is always requested in anticipation of an event that may not occur. This interface permits cancellation of the Firewall service action request. Typically, a firewall action relates only to events for which a filter is not registered.

For example, if the action is the future establishment of a secondary connection, the IFWXFirewallAction interface can be used to cancel the action if the primary connection is terminated.

The firewall may automatically cancel certain actions, including:

  • Actions that are supposed to happen only once (the action is canceled after its first occurrence).
  • Actions that have a time-out.
  • An action associated with a session that has been killed.

Requirements

Server Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version Requires Forefront Threat Management Gateway (TMG) 2010.
Header

Declared in Wspfwext.idl.

See Also

Filter Interfaces

Send comments about this topic to Microsoft

Build date: 6/30/2010