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 GetFilterVersionto obtain the version information about the filter.

Syntax

typedef struct _HTTP_FILTER_VERSION {
  DWORD 
dwServerFilterVersion;
  DWORD 
dwFilterVersion;
  CHAR 
lpszFilterDesc[SF_MAX_FILTER_DESC_LEN];
  DWORD 
dwFlags;
} HTTP_FILTER_VERSION, *PHTTP_FILTER_VERSION;

Members

dwServerFilterVersion

ISAPI filter version in use by the server.

dwFilterVersion

Version number of ISAPI used by the ISAPI filter.

lpszFilterDesc

Pointer to a null-terminated string containing a short description of the ISAPI filter.

dwFlags

Flags that indicate the event notification types for which the filter should be notified, and the filter priority. The following tables show the valid bitmasks.

Event Notification Types

The following table shows the event notification constants.

Event notification constant Place in event sequence

SF_NOTIFY_READ_RAW_DATA

Occurs when data is being read from the client. May occur more than once per request.

Note:
Registering ISAPI filters for raw data notifications is deprecated. Applications should write ISAPI extensions to process and generate data that is sent to and from the Web Server.

SF_NOTIFY_PREPROC_HEADERS

Occurs immediately after the Web Server has preprocessed headers, but before the Web Server has begun to process header content.

SF_NOTIFY_URL_MAP

Occurs after the Web Server has translated a URL to a physical path on the server.

SF_NOTIFY_AUTHENTICATION

Occurs just before the Web Server authenticates the client.

SF_NOTIFY_ACCESS_DENIED

Occurs just after the Web Server has determined that access is denied for the requested resource, but before the Web Server has sent a response to the client.

SF_NOTIFY_SEND_RESPONSE

Occurs after the request has been processed by the Web Server, but before any headers are sent back to the client.

Note:
Registering ISAPI filters for raw data notifications is deprecated. Applications should write ISAPI extensions to process and generate data that is sent to and from the Web Server.

SF_NOTIFY_SEND_RAW_DATA

Occurs as the Web Server sends raw data back to the client. May occur more than once per request.

SF_NOTIFY_END_OF_REQUEST

Occurs at the end of the request.

SF_NOTIFY_LOG

Occurs at the end of a request, just before the Web Server writes the transaction to the Web Server log.

SF_NOTIFY_END_OF_NET_SESSION

Occurs when the network session with the client is ending.

Filter Priority Settings

The following table shows the filter priority settings.

Priority constant Definition

SF_NOTIFY_ORDER_DEFAULT

Default priority level (medium priority).

SF_NOTIFY_ORDER_LOW

Low priority level.

SF_NOTIFY_ORDER_MEDIUM

Medium priority level.

SF_NOTIFY_ORDER_HIGH

High priority level.

Port Security Settings

The following table shows the priority constant definitions.

Priority constant Definition

SF_NOTIFY_SECURE_PORT

Notify the application only for connections over a secure port.

SF_NOTIFY_NONSECURE_PORT

Notify the application only for connections over a non-secure port.

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

Reference

HttpFilterProc