HTTP_FILTER_VERSION
A version of this page is also available for
4/8/2010
This structure is used by GetFilterVersion to 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 |