Microsoft KB Archive/289115

= XADM: How to Disable MAPI Clients at a Server Level Based on Client MAPI Provider Version =

PSS ID Number: 289115

Article Last Modified on 8/27/2002

-

The information in this article applies to:


 * Microsoft Exchange 2000 Server

-



This article was previously published under Q289115



IMPORTANT: This article contains information about modifying the registry. Before you modify the registry, make sure to back it up and make sure that you understand how to restore the registry if a problem occurs. For information about how to back up, restore, and edit the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows Registry



SUMMARY
An Exchange 2000 hotfix is now available that gives you the ability to disable Messaging Application Programming Interface (MAPI) clients by version at a server level. With this enhancement, you can restrict access to an Exchange 2000 server based on a single MAPI client version, a specific range of MAPI client versions, an open range of MAPI client versions, or a mix of all of the aforementioned scenarios.

This capability can be useful in preventing problematic or beta client MAPI providers from running against an Exchange 2000 server.



MORE INFORMATION
A supported feature that modifies the product's default behavior is now available from Microsoft, but it is only intended to modify the behavior that is described in this article. Apply it only to systems that specifically need it. This feature may receive additional testing. Therefore, if your system is not severely affected by the lack of this feature, Microsoft recommends that you wait for the next Microsoft Exchange 2000 Server service pack that contains this feature.

To obtain this feature immediately, contact Microsoft Product Support Services. For a complete list of Microsoft Product Support Services phone numbers and information about support costs, visit the following Microsoft Web site:

http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS

The English version of this feature should have the following file attributes or later:

Component: Information Store

After the hotfix is installed, you must create a new value in the registry to set the MAPI client versions that will be denied access to the Exchange 2000 server. MAPI client versions that are included in the range set in the new registry key receive the MAPI_E_LOGON_FAILED error message when they try to connect to the restricted Exchange 2000 server.

WARNING: If you use Registry Editor incorrectly, you may cause serious problems that may require you to reinstall your operating system. Microsoft cannot guarantee that you can solve problems that result from using Registry Editor incorrectly. Use Registry Editor at your own risk.

 Start Registry Editor (Regedt32.exe). Locate the following key in the registry:

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\MSExchangeIS\ParametersSystem

 On the Edit menu, click Add Value, and then add the following registry value:

Value name: Disable MAPI Clients

Data type: REG_SZ

Value:

The MAPI client version of currently attached clients can be seen in the Exchange System Manager Logons pane for each mailbox store. The client version is listed as X.0.Y.Z, from which you must use X.Y.Z to create the registry value.

You can specify an exact version to disable, a range of versions, several versions not in a range, or all versions above or below a particular revision. You may use a comma to separate version number values. For example:

5.2819.0

(to deny access for Outlook 2000 clients)

-5.2818.0

(to deny access for all clients prior to Outlook 2000)

5.3121.0-

(to deny access for Outlook 2000 Service Release 1 [SR1] and all later clients)

5.2819.0-5.3121.0

(to deny access for clients between Outlook 2000 and Outlook 2000 SR1)

5.2819.0, 5.3121.0

(to deny access for Outlook 2000 and Outlook 2000 Service Release 1 [SR1] clients only)

 Quit Registry Editor. Restart the Information Store service.

This feature will be included in Exchange 2000 Server Service Pack 1 (SP1).

Keywords: kbExchange2000SP1Fea kbFEA kbinfo KB289115

Technology: kbExchange2000Search kbExchange2000Serv kbExchangeSearch

-

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

© 2003 Microsoft Corporation. All rights reserved.