Microsoft KB Archive/176919

= PRB: IIS Fails to Display Custom Error Messages for .asp Files =

Article ID: 176919

Article Last Modified on 6/22/2005

-

APPLIES TO


 * Microsoft Internet Information Server 4.0

-



This article was previously published under Q176919



We strongly recommend that all users upgrade to Microsoft Internet Information Services (IIS) version 6.0 running on Microsoft Windows Server 2003. IIS 6.0 significantly increases Web infrastructure security. For more information about IIS security-related topics, visit the following Microsoft Web site:

http://www.microsoft.com/technet/security/prodtech/IIS.mspx



SYMPTOMS
When you retrieve a document with an extension that has a corresponding script map entry (for example, .asp, .stm, .idq ), the custom error messages configured to replace the default error messages are not used.



RESOLUTION
In cases where the default error messages are displayed instead of the configured custom error messages, the following workaround exists:


 * 1) From the Microsoft Management Console (MMC) IIS Snapin, right-click the Web site and click Properties.
 * 2) On the Home Directory tab, click the "Configuration" button.
 * 3) Highlight the extension that fails to return the custom error message and click Edit.
 * 4) Select the Check That File Exists option.
 * 5) Click OK, and then click Apply.



STATUS
This behavior is by design.



MORE INFORMATION
When a request is made to an IIS server for a registered file (such as an ASP page), IIS simply passes that request to the corresponding ISAPI extension. The ISAPI extension that is registered for that file type is responsible for the completion of the request, including the return of any errors to the user.

This allows the ISAPI extensions to return error messages that may relate more information than a standard error. When the "Check that file exists" option is enabled in the Add/Edit Application Extension Mapping dialog, this forces IIS to check and verify that the file exists, and the user has appropriate permissions prior to passing the request to the ISAPI extension. When this option is enabled and the file is missing, or the authenticated user has inappropriate permissions, IIS will return the appropriate custom error message.

Keywords: kbprb KB176919

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.