Applies to: desktop apps only

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;
  WORD  wPort;


  • 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.


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.


Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)


Forefront Threat Management Gateway (TMG) 2010



See also

Notification Structures



Build date: 7/12/2010