HTTP_FILTER_CONTEXT

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.

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

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

This value is always FALSE in Windows CE Web server.

pFilterContext

Points 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

Points to a function that retrieves information about the server and this connection. For some notifications, some variables may not be defined. For example, notifications which occur before PREPROC_HEADERS, such as the READ_RAW_DATA notification, may not be defined.

AddResponseHeaders

Points to the AddResponseHeadersfunction that adds a header to the HTTP response.

WriteClient

Points to the WriteClientfunction that sends raw data back to the client.

AllocMem

Points to the AllocMemfunction used to allocate memory. Any memory allocated with this function will automatically be freed when the session ends.

ServerSupportFunction

Points to the ServerSupportFunctionfunction used to extend the ISAPI filter functions. Parameters are specific to the extensions.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	3.0 and later	Httpfilt.h

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.