HTTP_FILTER_CONTEXT structure

  • Article

Applies to: desktop apps only

The HTTP_FILTER_CONTEXT structure is used for passing control and information associated with the current, active HTTP session in event notifications that are sent by the Forefront TMG Web proxy to Web filters by calling HttpFilterProc and HttpWPXFilterProc.

Syntax

typedef struct _HTTP_FILTER_CONTEXT {
  DWORD          cbSize;
  DWORD          Revision;
  PVOID          ServerContext;
  DWORD          ulReserved;
  BOOL           fIsSecurePort;
  PVOID          pFilterContext;
  BOOL (WINAPI)  *GetServerVariable;
  BOOL (WINAPI)  *AddResponseHeaders;
  BOOL (WINAPI)  *WriteClient;
  VOID* (WINAPI) *AllocMem;
  BOOL (WINAPI)  *ServerSupportFunction;
} HTTP_FILTER_CONTEXT, *PHTTP_FILTER_CONTEXT;

Members

  • cbSize
    The size of this structure, in bytes.

  • Revision
    The revision level of this structure.

  • ServerContext
    Reserved for server use.

  • ulReserved
    Reserved for server use.

  • fIsSecurePort
    A value of TRUE indicates that the event occurred over a secure port. A value of FALSE indicates that the event did not occur over a secure port.

  • pFilterContext
    Pointer to context information that the Web filter associates with the current, active HTTP session. It is initialized to NULL when the Web proxy creates the session, and it is set when the Web filter allocates memory to hold the context information. Any memory allocated for this context information can be safely freed during the SF_NOTIFY_END_OF_NET_SESSION notification.

  • GetServerVariable
    Pointer to the GetServerVariable function that retrieves information about the server and the current connection. For some notifications, some variables may not be defined. For example, notifications that occur before PREPROC_HEADERS, such as the READ_RAW_DATA notification, may have undefined variables.

  • AddResponseHeaders
    Pointer to the AddResponseHeaders function that adds a header to the HTTP response.

  • WriteClient
    Pointer to the WriteClient function that sends raw data back to the client.

  • AllocMem
    Pointer to the AllocMem function used to allocate memory. Any memory allocated with this function will automatically be freed when the session ends.

  • ServerSupportFunction
    Pointer to the ServerSupportFunction function used to extend the Web filter functions. Parameters are specific to the extensions.

Requirements

Minimum supported client

 None supported

Minimum supported server

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

Version

 Forefront Threat Management Gateway (TMG) 2010

Header

 Httpfilt.h

See also

Notification Structures

 

 

Build date: 7/12/2010