IFWXNetworkAddress Interface

The IFWXNetworkAddress interface represents an IP address of the Forefront TMG computer.

Each instance of the IFWXNetworkAddress interface is an element of a collection represented by an IFWXNetworkAddresses interface that can be retrieved from a snapshot by calling the IFWXNetConfigDetectionSnapshot::GetNetworkAddresses method.

An application filter that is registered as a network configuration detection (NCD) client can associate user-defined context information with each IFWXNetworkAddress 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 IFWXNetworkAddress : IUnknown

Methods

The IFWXNetworkAddress interface inherits the methods of the IUnknown interface.

In addition, IFWXNetworkAddress defines the following methods.

Method Description

SetContext

Sets the context information for the IP address.

GetContext

Retrieves the context information for the IP address.

GetAddress

Retrieves the IP address.

GetMask

Retrieves the subnet mask for the IP address.

GetNetworkAdapter

Retrieves a pointer to the IFWXNetworkAdapter interface to which the IP address belongs.

GetNetworkElement

Retrieves a pointer to the IFWXNetworkElement interface to which the IP address belongs.

IsPrimaryIpAddress

Determines whether the network address is the primary IP address for the network adapter.

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.

[an error occurred while processing this directive]