WPX_FILTER_ROUTE Structure

The Forefront TMG Web proxy includes a pointer to the WPX_FILTER_ROUTE structure when it forwards the request to the Web server. If your filter should be notified for this event, it must register to receive SF_NOTIFY_ROUTING notifications. For more information about the types of event notifications that are sent to Web filters, see Event Notifications.

Syntax

typedef struct _WPX_FILTER_ROUTE {

  CHAR* pszHost;

  DWORD cbInHost;

  WORD wPort;
} WPX_FILTER_ROUTE, 

 *PWPX_FILTER_ROUTE;

Members

pszHost

Null-terminated string that specifies the host name or IP address.

cbInHost

The size of the buffer pointed to by pszHost.

wPort

The port for the host.

Remarks

The SF_NOTIFY_ROUTING notification is sent each time that a request is forwarded to a Web server, upstream proxy server, or to another Forefront TMG computer within the array. This structure can be used to change the host, IP address, or port to which Forefront TMG will forward the request.

If the request is routed either to another Forefront TMG computer within the array or to an upstream proxy server and a connection to the server cannot be established, the server will be marked as down, another route to the destination will be calculated if possible, and an attempt will be made to connect to a different server. This process will be repeated three times before failing the request, and an SF_NOTIFY_ROUTING notification will be sent before each attempt to establish a connection.

Requirements

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wpxhttpfilt.h.

See Also

Notification Structures

Send comments about this topic to Microsoft

Build date: 11/30/2009