Export (0) Print
Expand All

HTTP_FILTER_VERSION Structure (IIS)

IIS 6.0

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

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

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

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:
© 2014 Microsoft