HTTP_FILTER_VERSION Structure (IIS)

  • Article

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;

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

Requirements

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.

See Also