Share via

Event ID 2219 — 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: 2219
Source: Microsoft-Windows-IIS-WMSVC
Version: 7.0
Symbolic Name: W3_EVENT_EXTENSION_EXCEPTION
Message: The HTTP server encountered an unhandled exception while processing the ISAPI Application '%1'.

Resolve

Correct an ISAPI load failure

If an ISAPI Filter fails to load, possible resolutions include the following:

  • Contact the ISAPI vendor regarding the error. The vendor should have more specific knowledge about the filter's features and behavior.
  • If the ISAPI failed to load because of a processor mismatch, see Knowledge Base article 894435.
  • Check the event log message for a specific error number included in the message. This error number will be different from the Event ID. To do this, see the steps below.

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

Check for a specific error number

To check for a specific error number:

  1. In the Event Viewer, select the event that you received.
  2. Click the Details tab, then Friendly View.
  3. If a specific error number is available, the words Binary data: should appear.
  4. Below In Words, note the number after the colon.

Find out more about a specific error number

To learn more about a specific error number:

  1. Download the Err.exe utility from the Microsoft Exchange Server Error Code Look-up page.
  2. Click Start, All Programs, Accessories, and then Command Prompt.
  3. At the command prompt, navigate to the directory where you downloaded Err.exe. For example, if you downloaded Err.exe to C:\Err, type cd C:\Err.
  4. Type err errornumber to obtain more information about the error. For example, if the specific error number is 80070005, type err 80070005.
  5. In the example described in the previous section, the error resolves to ERROR_ACCESS_DENIED, so your next step would be to check permissions on the ISAPI DLL.

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