IFWXSessionFilter Interface

The IFWXSessionFilter interface exposes a method that the Microsoft Firewall service can use to send notifications about events that the filter is registered to handle in a specific user session. Each user session may have a different combination of session filters attached to it. However, each session filter is attached to a single user session.

An instance of the session filter object is created for a user session when the Firewall service calls the IFWXFilter::AttachToSession method.

This is the interface typically used for attaching a data filter to a user session.

For more information about how the IFWXSessionFilter interface is used in application filters, see Filter Object Model.

For more information about implementing the IFWXSessionFilter interface, see Implementing a Session Filter Object.

Syntax

interface IFWXSessionFilter : IUnknown

When To Implement

Every application filter must implement this interface to receive notifications for events in a user session and to react to these events.

Methods

The IFWXSessionFilter interface inherits the methods of the IUnknown interface.

In addition, IFWXSessionFilter defines the following methods.

Method Description

FirewallEventHandler

Notifies the filter that the Microsoft Firewall service detected an event related to the user session to which the session filter is attached.

Detach

Detaches the session filter from its session. This method should release all references that the session filter object holds on the session and any related objects.

Requirements

Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
Header

Declared in Wspfwext.idl.

See Also

Filter Interfaces


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.