ISAPI Filters (Windows CE 5.0)

Send Feedback

ISAPI filters are DLLs that are loaded into the process of the Web Server when it is started, and they stay in memory until the Web Server shuts down. After they are loaded, ISAPI filters can be configured to receive a number of special filter-event notifications that occur with each HTTP request that the Web Server receives and with each response that the Web Server generates in return.

When an ISAPI filter is loaded, the filter passes a structure to the Web Server that contains, in addition to other information, a bit field that specifies the types of filter-event notifications for which the filter should be notified. Each time that the event occurs, an event notification is started and every ISAPI filter that is set to monitor that event is notified.

Registering ISAPI filters for raw data notifications (SF_NOTIFY_READ_RAW_DATA and SF_NOTIFY_SEND_RAW_DATA notification types) is deprecated. Applications should write ISAPI extensions to process and generate data that is sent to and from the Web Server.

Note   On Windows CE, having raw read filters return SF_STATUS_REQ_READ_NEXT to retrieve more data is discouraged. In almost all cases, post data should be handled by ISAPI Extensions, instead of directly by a filter. Raw send and receive filters should only be used for processing binary data, such as compressed data that the Web Server otherwise could not parse. If multiple filters are registered to receive SF_NOTIFY_READ_RAW_DATA event, none of them should be SF_STATUS_REQ_READ_NEXT. Otherwise, the results are undefined and may be different than would occur on IIS.

See Also

ISAPI Extensions | ISAPI Extensions, Filters, and Script Mapping

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.