HTTP_FILTER_VERSION

A version of this page is also available for

Windows Embedded CE 6.0 R3

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

See Also

Reference

HttpFilterProc