Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure is used by HttpFilterProcto 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 AddResponseHeadersfunction 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 AllocMemfunction 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
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also