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.


typedef struct _WPX_FILTER_ROUTE {
CHAR* pszHost;
DWORD cbInHost;



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


The size of the buffer pointed to by pszHost.


The port for the host.


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.


Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).

Declared in Wpxhttpfilt.h.

See Also

Notification Structures

Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.