HTTP_FILTER_VERSION

This structure is used by GetFilterVersion to obtain the version information about the filter.

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

The ISAPI version in use by the server.

dwFilterVersion

The version number of ISAPI used by the ISAPI filter. The version used by your filter can be set by using the HTTP_FILTER_REVISION definition from the httpfilt.h header file.

lpszFilterDesc

Points to a null-terminated string that provides a short description of the ISAPI filter.

dwFlags

Contains flags that indicate for which notification event types the filter should be notified, and what the filter's priority is. The following table lists the valid bitmasks.

Event Notification Types:

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.
SF_NOTIFY_PREPROC_HEADERS	Occurs immediately after IIS has pre-processed headers, but before IIS has begun to process header content.
SF_NOTIFY_URL_MAP	Occurs after IIS has translated a URL to a physical path on the server.
SF_NOTIFY_AUTHENTICATION	Occurs just before IIS authenticates the client.
SF_NOTIFY_ACCESS_DENIED	Occurs just after IIS has determined that access is denied for the requested resource, but before IIS has sent a response to the client.
SF_NOTIFY_SEND_RESPONSE	Occurs after the request has been processed by IIS, but before any headers are sent back to the client.
SF_NOTIFY_SEND_RAW_DATA	Occurs as IIS 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 IIS writes the transaction to the IIS log.
SF_NOTIFY_END_OF_NET_SESSION	Occurs when the network session with the client is ending.

Filter Priority Settings:

Priority Constant	Meaning
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:

Priority Constant	Meaning
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 nonsecure port.

For more detailed information about the ISAPI filter event sequence, see Event Notification Order.

See Also

HttpFilterProc