HTTP_FILTER_CONTEXT Structure (IIS)

  • Article

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;

Members

  • 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.

Requirements

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.

See Also