filter Element for isapiFilters [IIS Settings Schema]

Article
10/21/2021

Note

For more information about the filter element, see the following topic on the Microsoft IIS.net Web site: Filter <filter>.

Configures an ISAPI filter to process client request data or server response data.

Syntax

Attributes and Elements

The following sections describe attributes, child elements, and parent elements for this section.

Attributes

enableCache

Optional Boolean attribute.

Specifies whether HTTP.sys caching is enabled (true) or disabled (false) for filtered server responses.

The default value is false.

enabled

Optional Boolean attribute.

Specifies whether the installed filter is enabled (true) or disabled (false).

The default value is true.

name

Required string attribute.

Specifies the unique name of the ISAPI filter.

path

Required string attribute.

Specifies the full physical path of the ISAPI filter .dll file.

preCondition

Optional string attribute.

Specifies conditions under which the ISAPI filter will run.

The preCondition attribute can be one or more of the following possible values. If you specify more than one value, separate the values with a comma (,).

Value	Description
bitness32	Specify the bitness32 value when the ISAPI filter is a 32-bit .dll file and IIS should load the filter only for worker processes that run in WOW64 mode (32-bit simulation) on a 64-bit operating system.
bitness64	Specify the bitness64 value when the ISAPI filter is a 64-bit .dll file and IIS should load the filter only for worker processes that run in 64-bit mode.
integratedMode	Specify the integratedMode value when the ISAPI filter should use the integrated request-processing pipeline to process requests for managed content.
ISAPIMode	Specify the ISAPIMode value when the ISAPI filter should use the ASP.NET ISAPI extension, aspnet_isapi.dll, to process requests for managed content.
runtimeVersionv1.1	Specify the runtimeVersionv1.1 value when the ISAPI filter should load only for application pools that are configured to use .NET Framework version 1.1.
runtimeVersionv2.0	Specify the runtimeVersionv2.0 value when the ISAPI filter should load only for application pools that are configured to use .NET Framework version 2.0.

Child Elements

None.

Parent Elements

Element	Description
configuration	Specifies the root element in every configuration file that is used by IIS 7.
system.webServer	Specifies the top-level section group (in ApplicationHost.config) in which this element is defined.
isapiFilters	Specifies configuration settings for ISAPI filters on a Web server.

Remarks

For more information about the filter element, see the following topic on the Microsoft IIS.net Web site: Filter <filter>.

Element Information

Configuration locations

Machine.config

ApplicationHost.config

Root application Web.config

Application Web.config

Requirements

Microsoft Internet Information Services (IIS) version 7.0

Partager via