IFWXNetworkSet Interface

The IFWXNetworkSet interface represents a network set defined by an FPCNetworkSet object in the stored Forefront TMG configuration.

Each instance of the IFWXNetworkSet interface is an element of a collection represented by an IFWXNetworkSets interface that can be retrieved from a snapshot by calling the IFWXNetConfigDetectionSnapshot::GetNetworkSets method. The membership of a network element represented by an IFWXNetworkElement interface in a network set is specified by an FwxNetElementMembershipInNetworkSet structure.

An application filter that is registered as a network configuration detection (NCD) client can associate user-defined context information with each IFWXNetworkSet interface. The context information is stored in an object that implements the IUnknown interface and is allocated by the application filter. The application filter can then use this information to perform actions in response to notifications for NCD events that it receives when the Firewall service calls the IFWXNetConfigDetectionNotification::NotifyNetworkChange method. This way, information about each network element can be stored the first time that a notification is received for it, and it is not necessary to retrieve the information from the stored configuration for each subsequent NCD event.

Syntax

interface IFWXNetworkSet : IUnknown

Methods

The IFWXNetworkSet interface inherits the methods of the IUnknown interface.

In addition, IFWXNetworkSet defines the following methods.

Method	Description
SetContext	Sets the context information for the network set.
GetContext	Retrieves the context information for the network set.
GetGUID	Retrieves the GUID of the network set.
GetNetworkElements	Retrieves the network elements that comprise the network set.

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