Checking ISAPI Filter Status

  • Article

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1

When you add an ISAPI filter to a site on IIS 6.0, the Status column in the list of filters is empty. Until a request is made for the site and an attempt is made to load the filter, the status of the filter is not known. After the request is made, the status of the filter is displayed either as a red arrow if the filter did not load or as a green arrow if the filter loaded successfully.

Note

This behavior is different from the behavior in IIS 5.0, where the filter was loaded dynamically as soon as it was added to the site, regardless of whether a request was made to the site.

Procedures

Important

You must be a member of the Administrators group on the local computer to perform the following procedure or procedures. As a security best practice, log on to your computer by using an account that is not in the Administrators group, and then use the runas command to run IIS Manager as an administrator. At a command prompt, type runas /user:Administrative_AccountName "mmc %systemroot%\system32\inetsrv\iis.msc".

To check the ISAPI filter status

  1. In IIS Manager, right-click the Web site or virtual server on which the ISAPI filter is installed, and then click Properties.

  2. Click the ISAPI Filters tab, and then, in the Status column, check the ISAPI filter status.

    A green arrow indicates that the last ISAPI filter installed correctly. A red arrow indicates that a filter failed the last time the worker process started.

  • For information about adding ISAPI filters and changing the load order of filters, see Installing ISAPI Filters.

  • For information about how to fine-tune server performance by caching ISAPI extensions, see Configuring ISAPI Extensions.

  • For more information about ISAPI filters, see ISAPI Reference in the IIS Software Development Kit (SDK).