HTTP_FILTER_CONTEXT (Windows Embedded CE 6.0)

1/6/2010

This structure is used by HttpFilterProc to obtain information about the current request. This structure is very similar in function to an ISAPI extension's EXTENSION_CONTROL_BLOCK.

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
  Size, in bytes, of this structure.

• Revision
  Revision level of this structure.

• ServerContext
  Reserved for server use.

• ulReserved
  Reserved for server use.

• fIsSecurePort
  TRUE if the event is over a secure port, and FALSE otherwise.

• pFilterContext
  Pointer to any context information that the filter wants to associate with this request. Any memory associated with this request can be safely freed during the SF_NOTIFY_END_OF_NET_SESSION notification.

• GetServerVariable
  Pointer to the GetServerVariable (ISAPI Filters) function that retrieves information about the server and this connection. For some notifications, some variables might not be defined. For example, notifications that occur before SF_NOTIFY_PREPROC_HEADERS, such as SF_NOTIFY_READ_RAW_DATA, might not be defined.

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

• WriteClient
  Pointer to the WriteClient (ISAPI Filters) 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 (ISAPI Filters) function used to extend the ISAPI filter functions.

Requirements

Header	httpfilt.h
Windows Embedded CE	Windows CE 3.0 and later

See Also

Reference

Web Server Structures
AllocMem
GetServerVariable (ISAPI Extensions)
ServerSupportFunction (ISAPI Filters)
WriteClient (ISAPI Filters)