Important This article contains information about how to edit the metabase. Before you edit the metabase, verify that you have a backup copy that you can restore if a problem occurs. For information about how to do this, see the "Configuration Backup/Restore" Help topic in Microsoft Management Console (MMC).
The Password Change pages that are included with Microsoft Internet Information Services (IIS) 6.0 on a Microsoft Windows Server 2003 system have multiple problems. You can resolve these problems by installing the hotfix that is described in this article.
You may experience the following problems with the Password Change pages that are included with Microsoft Internet Information Services (IIS) 6.0:
The first letter of the user's account name is truncated.
The domain name is not correctly populated.
You cannot change passwords for users whose passwords must be changed at the next logon.
You cannot change passwords for users whose passwords have expired.
You cannot change passwords across forests.
You cannot use user names in the UPN format.
Most of the problems that are associated with the Change Password pages occur because of the technological limitations of Active Directory Service Interfaces (ADSI) when ADSI is used in an Active Server Pages (ASP) page on a Web site.
Service pack information
To resolve this problem, obtain the latest service pack for Windows Server 2003. For more information, click the following article number to view the article in the Microsoft Knowledge Base:
889100 How to obtain the latest service pack for Windows Server 2003
Note The files from this hotfix are included in Windows Server 2003 Service Pack 1 (SP1). This hotfix package automatically registers Iispwchg.dll. However, you must manually register this DLL if you install Windows Server 2003 SP1. For more information, see the "More Information" section.
A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.
If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.
Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site:
Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.
Details for the first package
No prerequisites are required.
You must restart your computer after you apply this hotfix.
Hotfix replacement information
This hotfix does not replace any other hotfixes.
The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
Microsoft Windows Server 2003 for Itanium-based Systems Date Time Version Size File name -------------------------------------------------------------- 29-Dec-2004 23:52 5,735 Achg.asp 29-Dec-2004 23:52 2,833 Aexp2b.asp 29-Dec-2004 23:52 2,841 Aexp4b.asp 22-Jun-2005 10:55 5.2.3790.354 56,832 Iispwchg.dll IA64 22-Jun-2005 10:55 6.0.3790.354 21,504 W3comlog.dll IA64 22-Jun-2005 10:55 6.0.3790.354 951,296 W3core.dll IA64 Microsoft Windows Server 2003 Date Time Version Size File name -------------------------------------------------------------- 26-Dec-2004 21:38 5,735 Achg.asp 26-Dec-2004 21:38 2,833 Aexp2b.asp 26-Dec-2004 21:38 2,841 Aexp4b.asp 22-Jun-2005 13:54 5.2.3790.354 28,672 Iispwchg.dll 22-Jun-2005 13:54 6.0.3790.354 9,728 W3comlog.dll 22-Jun-2005 13:54 6.0.3790.354 342,528 W3core.dll
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
Warning If you edit the metabase incorrectly, you can cause serious problems that may require that you reinstall any product that uses the metabase. Microsoft cannot guarantee that problems that result if you incorrectly edit the metabase can be solved. Edit the metabase at your own risk.
Note Always back up the metabase before you edit it.
After you apply this hotfix, follow these steps to configure the Password Change functionality:
1. Apply the hotfix to update the files on the computer that is running IIS or install service pack 1 for Windows 2003. The hotfix will automatically register the module and you can proceed to step 3. If Service Pack 1 has been installed without the hotfix, you must manually register the module.
Register the IISpwchg.dll file in the Iisadmpwd directory:
Click Start, and then click Run.
In the Open box, type the following, and then press ENTER:
Configure the PasswordChangeFlags property in the metabase to make sure that the Password Change functionality is enabled:
Click Start, and then click Run.
In the Open box, type cmd, and then press ENTER.
Locate the C:\Inetpub\Adminscripts directory.
Type the following command, and then press ENTER:
cscript.exe adsutil.vbs set w3svc/passwordchangeflags Value
Note In this sample command, Value is a placeholder for the value that you want to set for the PasswordChangeFlags property.
The following list includes the possible values for the PasswordChangeFlags property. You can use a combination of these values.
0: This is the default value. This value indicates that you must use a Secure Sockets Layer (SSL) connection when you change the password.
1: This value permits password changes on non-secure ports. This value is useful if SSL is not enabled.
2: This value disables the Password Change functionality.
4: This value disables the advance notification of password expiration.
Make sure that the virtual directory for the Iisadmpwd directory is correctly created and that it points to the correct location. The correct location is System32\Inetsrv\Iisadmpwd.
To create a virtual directory for the Iisadmpwd directory, follow these steps:
Click Start, click Programs, click Administrative Tools, and then click Internet Information Services (IIS) Manager.
In Internet Information Services (IIS) Manager, right-click the Web site where you want the Iisadmpwd folder, click New, and then click Virtual Directory.
When the Virtual Directory Creation Wizard starts, follow the instructions to create the virtual directory with the alias that is named "IISADMPWD." Make sure that the path points to the Windows\System32\Inetsrv\Iisadmpwd directory. Make sure that both "Read" permissions and "Run Scripts (such as ASP)" permissions are selected.
Make sure that the Iisadmpwd virtual directory runs in the same application pool as the Web site that uses the Password Change functionality. For example, if the Password Change functionality is used in your Microsoft Outlook Web Access (OWA) Web site, the Iisadmpwd virtual directory must run inside the Exchange application pool where the OWA site resides.
Note We recommend that the authentication for IISADMPWD is the same as the application that is using this functionality. Anonymous Authentication is not required to be enabled on this virtual directory.
Verify that the following metabase entries are set correctly.
Note If the metabase is manually changed by using an XML Editor to edit any of these metabase entries and values, the XML editor will automatically insert the tag for a double-quote character. This will result in two double-quote characters in the metabase. To work around this, either edit the Metabase.xml file in a non-XML editor (Notepad.exe, for example) or use the XML tag for the double-quote character. The XML tag for the double-quote character is ". After you edit the Metabase.xml file, review the changes to verify that " does not appear as a opening tag and a closing tag in the changes. The "" and "" syntax causes a failure.
Metabase entry and value
AuthChangeURL = "/iisadmpwd/achg.asp"
This page does the actual password change work.
AuthExpiredURL = "/iisadmpwd/aexp.asp"
This page displays the password change form for a user whose password has expired. Make sure that you type the account name in the "domain\username" format.
This page displays the password change form when SSL is not used.
AuthNotifyPwdExpURL = "/iisadmpwd/anot.asp"
This page appears when a user's password expires earlier than the number of days that are specified in the PasswordExpirePreNotifyDays entry.
This page appears if a user's password expires earlier than the number of days that are specified in the PasswordExpirePreNotifyDays entry when SSL is not used.
This metabase entry specifies the number of days that remain before the client's password expires. This metabase entry also indicates when a password pre-notification message is sent.
By default, these metabase entries are located at the W3SVC level in the metabase. You can use the Adsutil.vbs script to configure these metabase entries. The Adsutil.vbs script is located in the Inetpub\Adminscripts directory on your system. To use the Adsutil.vbs script to configure these metabase entries, follow these steps:
At a command prompt, locate the C:\Inetpub\Adminscripts directory.
Type the following command, and then press ENTER:
cscript.exe adsutil.vbs set w3svc/MetabaseEntry Value
For example, type the following:
cscript.exe adsutil.vbs set w3svc/PasswordExpirePreNotifyDays 4
For more information about the naming schema for Windows software updates, click the following article number to view the article in the Microsoft Knowledge Base:
816915 New file naming schema for Microsoft Windows software update packages
For more information about the terminology that is used to describe Microsoft product updates, click the following article number to view the article in the Microsoft Knowledge Base:
824684 Description of the standard terminology that is used to describe Microsoft software updates