Share via


HTTP_FILTER_VERSION (Compact 2013)

3/26/2014

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 filter priority and the event notification types for which the filter should be notified. 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_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.

    Ee501274.note(en-us,WinEmbedded.80).gifNote:
    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_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

See Also

Reference

Web Server Structures
HttpFilterProc