IFWXNetConfigDetector Interface

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.

Syntax

interface IFWXNetConfigDetector : IUnknown

Methods

The IFWXNetConfigDetector interface inherits the methods of the IUnknown interface.

In addition, IFWXNetConfigDetector defines the following methods.

Method Description

Register

Registers an application filter to receive NCD events.

Unregister

Unregisters an application filter from receiving NCD events.

LookupNetworkElementByAddress

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

GetCurrentSnapshot

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

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.

508 Resource Limit Is Reached

Resource Limit Is Reached

The website is temporarily unable to service your request as it exceeded resource limit. Please try again later.