Microsoft KB Archive/289115

From BetaArchive Wiki
Knowledge Base


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:

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

Component: Information Store

File name Version
Store.exe 6.0.4638.00



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.

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

    HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\MSExchangeIS\ParametersSystem

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

    Value name: Disable MAPI Clients
    Data type: REG_SZ
    Value: version or range of versions

    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)

  4. Quit Registry Editor.
  5. 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