ISAPI Filters

 

Applies To: Windows Server 2012 R2, Windows Server 2012

Use the ISAPI Filters feature page to manage a list of .dll files that change or enhance the functionality provided by IIS. For example, an ISAPI filter can control which files are mapped to a URL, modify the response sent by the server, or perform other actions to modify the behavior of the server.

Note

ISAPI filters and extensions are replaced by the new IIS 8 modules API. For more information about the IIS 8 modules API, see Native-Code HTTP Modules.

Sort the list by clicking one of the feature page column headings or select a value from the Group by drop-down list to group similar items.

Related scenarios

In this document

UI Elements for ISAPI Filters

The following tables describe the UI elements that are available on the feature page and in the Actions pane.

Feature Page Elements

Element Name

Description

Name

Displays the name of the ISAPI filter.

Executable

Displays the path of the ISAPI filter .dll file, for example, %SystemDrive%\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_filter.dll.

Entry Type

Displays whether the item is local or inherited. Local items are read from the current configuration file, and inherited items are read from a parent configuration file.

Actions Pane Elements

Element Name

Description

Add

Opens the Add ISAPI Filter dialog box in which you can add an ISAPI filter.

Edit

Opens the Edit ISAPI Filter dialog box in which you can edit the selected ISAPI filter.

Rename

Enables the Name field of the selected ISAPI Filter so you can rename it.

Remove

Removes the item that is selected from the list on the feature page.

Note

If you are removing an ISAPI filter at the server level, restart WWW Service (W3SVC) for the changes to take effect.

Revert to Inherited

Reverts the feature to inherit settings from the parent configuration. This setting deletes local configuration settings, including items from the list, for this feature. This action is not available at the server level.

View Ordered List

Displays the list in order of configuration. When you select the ordered list format, you can only move items up and down in the list. Other actions in the Actions pane do not appear until you select the unordered list format.

Move Up

Moves up a selected item in the list. This action is available only when viewing items in the ordered list format.

Note

When items in the list are reordered at a child level, the child no longer inherits settings from the parent level. This loss of inheritance includes any items that are added to or removed from the list at the parent level. If you want to inherit settings from a parent level, revert all of the changes at the child level by using the Revert to Inherited action in the Actions pane.

Move Down

Moves a selected item down in the list. This action is available only when viewing items in the ordered list format.

Note

When items in the list are reordered at a child level, the child no longer inherits settings from the parent level. This loss of inheritance includes any items that are added to or removed from the list at the parent level. If you want to inherit settings from a parent level, revert all of the changes at the child level by using the Revert to Inherited action in the Actions pane.

View Unordered List

Displays the list in an unordered format. When you select the unordered list format, you can sort and group items in the list, and perform actions in the Actions pane.

Add or Edit ISAPI Filter Dialog Box

Use the Add ISAPI Filter and Edit ISAPI Filter dialog boxes to add or edit a .dll file that changes or enhances the functionality of IIS.

Element Name

Description

Filter name

Type the name of the ISAPI filter.

Executable

Type the path of the ISAPI filter .dll file. For example, %SystemDrive%\Windows\Microsoft.NET\Framework\v2.0.50727\aspnet_filter.dll.