IFWXNetConfigDetectionNotification Interface

The IFWXNetConfigDetectionNotification interface includes a method for receiving a notification about a network configuration detection (NCD) event from the Microsoft Firewall service. An NCD event indicates that a change has been made to the network configuration. By registering for these events, an application filter can react appropriately to changes in network configuration. For example, if your application filter listens for Firewall service events on a particular network, you can use NCD events so that the filter can respond to changes to the network configuration, such as the addition of a network adapter. The filter can then be aware of where to listen for Firewall service events, even though the network configuration has changed. Note that notifications about changes in enterprise networks or enterprise network sets are not generated. For more information, see Using Network Configuration Detection.

For more information about NCD events, see the FwxNcdEvent structure, the FwxNcdEventType enumerated type, and the FwxNcdEventParameters union.

Syntax

interface IFWXNetConfigDetectionNotification : IUnknown

When To Implement

An application filter that needs to receive notifications about NCD events from the Firewall service and handle these events must implement this notification interface.

Methods

The IFWXNetConfigDetectionNotification interface inherits the methods of the IUnknown interface.

In addition, IFWXNetConfigDetectionNotification defines the following method.

Method Description

NotifyNetworkChange

Receives a notification from the Firewall service about a network configuration detection (NCD) event and handles the event. Application filters must implement this method to handle NCD events.

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