IFWXNetworkElement interface
Applies to: desktop apps only
The IFWXNetworkElement interface represents a network element, which corresponds to a network defined by an FPCNetwork object in the stored Forefront TMG configuration.
Each instance of the IFWXNetworkElement interface is an element of a collection represented by an IFWXNetworkElements interface that can be retrieved from a snapshot by calling the IFWXNetConfigDetectionSnapshot::GetNetworkElements method. The membership of a network element in a network set represented by an IFWXNetworkSet interface 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 IFWXNetworkElement 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.
Members
The IFWXNetworkElement interface inherits from the IUnknown interface. IFWXNetworkElement also has these types of members:
- Methods
Methods
The IFWXNetworkElement interface has these methods.
| Method | Description |
|---|---|
| GetConnectingNetworkGUID | Retrieves the GUID of the connecting network. |
| GetContext | Retrieves the context information for the network element. |
| GetGUID | Retrieves the GUID of the network element. |
| GetName | Retrieves the name of the network element. |
| GetType | Retrieves a value from the FpcNetworkTypes enumerated type that specifies the type of network element. |
| IsLocalAddress | Verifies whether the specified IP address is contained in the network element and is an IP address of the local computer. |
| SetContext | Sets the context information for the network element. |
Requirements
Minimum supported client |
None supported |
Minimum supported server |
Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only) |
Version |
Forefront Threat Management Gateway (TMG) 2010 |
Header |
Wspfwext.idl |
See also
Build date: 7/12/2010