IFWXNetConfigDetector interface

Applies to: desktop apps only

The IFWXNetConfigDetector interface is the interface that is used to register an application filter to receive notifications for network configuration detection (NCD) events. When an application filter is an NCD client, it can retrieve a snapshot of the current network configuration whenever a change in the configuration occurs. When the network configuration information is provided to a registered application filter, information about each element (address, adapter, network) of the configuration snapshot is provided separately.

Note  Snapshots do not include enterprise networks or enterprise network sets, and no notifications are generated for changes in enterprise networks or enterprise network sets.

NCD notifications are incremental. When a change in the network configuration occurs, the NCD mechanism informs its clients of the change in the configuration, such as a notification regarding the creation of a new network set, followed by a notification regarding the deletion of a network element. The last notification in every configuration change indicates the end of the information regarding the change. It informs the NCD client that it is now synchronized with the snapshot that the NCD mechanism holds. This synchronization notification also contains the new snapshot information.

The IFWXNetConfigDetector::Register method creates a registration handle, in which you can store and reuse information about the NCD objects you use. When an application filter registers as an NCD client, as part of the registration process it will receive all the incremental notifications required to compose the current network configuration snapshot.

For more information, see Using Network Configuration Detection.


The IFWXNetConfigDetector interface inherits from the IUnknown interface. IFWXNetConfigDetector also has these types of members:

  • Methods


The IFWXNetConfigDetector interface has these methods.

Method Description

Gets a pointer to an IFWXNetConfigDetectionSnapshot interface that represents a snapshot of the current network configuration.


Retrieves an IFWXNetworkElement interface that represents the Forefront TMG network to which the specified IP address belongs.


Registers an application filter to receive NCD events.


Unregisters an application filter from receiving NCD events.



Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)


Forefront Threat Management Gateway (TMG) 2010



See also

Filter Interfaces



Build date: 7/12/2010