Microsoft Internet Security and Acceleration Server 2004 SDK

IFWXGetXByY

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

Methods in Vtable Order

The IFWXGetXByY interface inherits the methods of the standard COM interface IUnknown.

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 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Wspfwext.idl.

See Also

Filter Interfaces