Share via


IsapiFilterElement Class [IIS 7 and higher]

Specifies an ISAPI filter.

Syntax

class IsapiFilterElement : CollectionElement

Methods

This class contains no methods.

Properties

The following table lists the properties exposed by the IsapiFilterElement class.

Name

Description

EnableCache

A read/write boolean value. true if IIS allows HTTP.sys caching for requests that go through the ISAPI filter; otherwise, false. If true, a particular request goes through the filter only once. After that, the response is cached by HTTP.sys and the filter is no longer involved. The default is false.

Enabled

A read/write boolean value. true if the ISAPI filter is enabled; otherwise, false. The default is true.

Name

A read-only string value that specifies the name of the ISAPI filter. The only key property.

Path

A required nonempty read/write string value that specifies the full physical path to the DLL file of the ISAPI filter.

PreCondition

A read/write string value that specifies a condition that must be satisfied before the ISAPI filter is loaded. The possible values are listed later in the Remarks section.

Subclasses

This class contains no subclasses.

Remarks

Instances of this class are contained in the IsapiFilters property of the IsapiFiltersSection class.

The following table lists the possible values for the PreCondition property. The default is null.

Value

Description

bitness32

IIS loads the ISAPI filter only for 32-bit worker processes.

bitness64

IIS loads the ISAPI filter only for 64-bit worker processes.

Inheritance Hierarchy

CollectionElement

   IsapiFilterElement

Requirements

Type

Description

Client

Requires IIS 7 on Windows Vista.

Server

Requires IIS 7 on Windows Server 2008.

Product

IIS 7

MOF file

WebAdministration.mof

See Also

Reference

CollectionElement Class [IIS 7 and higher]

IsapiFiltersSection Class [IIS 7 and higher]