HTTP_FILTER_CONTEXT Structure (IIS)

IIS 6.0

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


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

cbSize

The size of this structure, in bytes.

Revision

The revision level of this structure. This is less than or equal to the version of the document, HTTP_FILTER_REVISION.

ServerContext

Reserved for server use.

ulReserved

Reserved for server use.

fIsSecurePort

A value of TRUE indicates that this event is over a secure port. A value of FALSE indicates that the event is not over a secure port.

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 that occur before PREPROC_HEADERS, such as the READ_RAW_DATA notification, may not be defined.

AddResponseHeaders

Points to the AddResponseHeaders function that adds a header to the HTTP response.

WriteClient

Points to the WriteClient function that sends raw data back to the client.

AllocMem

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

ServerSupportFunction

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

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in httpfilt.h.

Show: