Event ID 2223 — IIS ISAPI Functionality

  • Article

Applies To: Windows Server 2008

Internet Information Services (IIS) ISAPI (Internet Server Application Programming Interface) extensions and filters can extend and modify the request-processing capabilities of IIS. ISAPI filters require a long time to be written, offer no native support for session handling, and can be cumbersome to maintain. IIS 6.0 and IIS 7.0 run ISAPI applications in isolation to enhance server stability. While ISAPI filters can still be used in IIS 7.0, it is easier for developers to add managed or native modules that integrate into IIS 7.0’s new modular architecture.

Event Details

Product: Internet Information Services
ID: 2223
Source: Microsoft-Windows-IIS-WMSVC
Version: 7.0
Symbolic Name: W3_MSG_LOADED_FILTER_FROM_REG
Message: For compatibility with previous versions of IIS, the filter '%1' was loaded as a global filter from the registry. To control the filter with the Internet Service Manager, remove the filter from the registry and add it as a global filter with Internet Service Manager. Filters in the registry are stored at "HKLM\System\CurrentControlSet\Services\W3Svc\Parameters\Filter DLLs".

Resolve

Control an ISAPI filter by using IIS Manager

To control an ISAPI filter by using Internet Service Manager, follow these steps:

  • Remove the remove the filter from the registry.
  • Add the filter as a global filter with IIS Manager.

To perform these procedures, you must have membership in Administrators, or you must have been delegated the appropriate authority.

Remove the remove the filter from the registry

To remove the remove the filter from the registry:

Caution: Incorrectly editing the registry might severely damage your system. Before making changes to the registry, you should back up any valued data.

  1. Open an elevated Command Prompt window. Click Start, point to All Programs, click Accessories, right-click Command Prompt, and then click Run as administrator.
  2. Type regedit.
  3. In Registry Editor, expand the tree to the node HKLM\System\CurrentControlSet\Services\W3Svc\Parameters\Filter DLLs.
  4. Under the Name column, right-click the filter and click Delete.
  5. Exit Registry Editor.

Add the filter as a global filter with IIS Manager

To add the filter as a global filter with IIS Manager:

  1. Click Start, click Control Panel, and then click Administrative Tools.
  2. Right-click Internet Information Services (IIS) Manager and select Run as administrator.
  3. In the Connections pane, navigate to the level that you want to manage.
  4. In Features View, double-click ISAPI Filters.
  5. In the Actions pane, click Add...
  6. In the Add ISAPI Filter dialog box, specify the filter name and path of the executable file.

Verify

You can use IIS Manager to verify that an ISAPI filter is functional by using one of the following methods:

  • Performing a test browse on the Web site or application that uses the ISAPI filter.
  • Verifying that a worker process is running for the Web site or application that uses the ISAPI filter.

Note:  An IIS worker process does not exist until a request is made to the application pool for the Web site or application. For this reason, you may have to test browse the Web site or application before you can verify that a worker process is functional.

To perform these procedures, you must have membership in Administrators, or you must have been delegated the appropriate authority.

Perform a test browse on the Web site or application that is using the ISAPI filter

To perform a test browse by using IIS Manager:

  1. Click Start, click Control Panel, and then click Administrative Tools.
  2. Right-click Internet Information Services (IIS) Manager and select Run as administrator.
  3. In the Connections pane, expand the computer name.
  4. Expand Sites.
  5. Select the Web site or application that is using the ISAPI filter that you want to verify.
  6. In the Actions pane, click the link under Browse. If the Web page appears, the ISAPI filter is functional.

Verify that an application pool worker process is running for a Web site or application

To verify that an application pool worker process is running:

  1. Click Start, click Control Panel, and then click Administrative Tools.
  2. Right-click Internet Information Services (IIS) Manager and select Run as administrator.
  3. In the Connections pane, select the computer name.
  4. In Features View, under the Feature Name column heading, double-click the Worker Processes management feature. A list of currently active application pools and worker processes will appear.
  5. Examine the application pool corresponding to the Web site or application that uses the ISAPI filter. The State column for the worker process will indicate Running if the worker process is running.

IIS ISAPI Functionality

Internet Information Services (IIS) 7.0