IFWXGetXByY Interface

The IFWXGetXByY interface allows a filter to modify the result of remote gethostbyname or gethostbyaddr function calls made by a Firewall client.

Syntax

interface IFWXGetXByY : IUnknown

Methods

The IFWXGetXByY interface inherits the methods of the IUnknown interface.

In addition, IFWXGetXByY defines the following methods.

Method	Description
Deny	Denies the name resolution request.
SetResult	Sets the hostent structure that will be returned.

Remarks

The IFWXGetXByY interface is essentially used to override the gethostbyname or gethostbyaddr functions, returning a hostent structure with different contents than would have been returned by the unfiltered calls. The filter has to call this interface from within the IFWXSessionFilter::FirewallEventHandler method.

A typical use of this interface would be to return an IP address other than that requested by the client; that is, to redirect the request.

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