Microsoft KB Archive/262097

= XIMS: Internet Mail Service Extension Message Text Append and Prepend =

Article ID: 262097

Article Last Modified on 10/28/2006

-

APPLIES TO


 * Microsoft Exchange Server 5.5 Standard Edition

-



This article was previously published under Q262097



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
Internet Mail Service Extension (Imsext.dll) has several functions. This article covers the append and prepend capabilities of this dynamic-link library (DLL). Message journaling is also a capability of Internet Mail Service Extension, but message journaling is not covered in this article. For additional information about message journaling, click the article number below to view the article in the Microsoft Knowledge Base:

262122 XIMS: Internet Mail Service Extension Message Journaling



Installing Internet Mail Service Extension
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.

To install Internet Mail Service Extension (Imsext.dll):  To copy the Internet Mail Service Extension to your server, do one of the following:  Locate the Internet Mail Service Extension in the following folder:

Exchsrvr\Connect\Msexcimc\Bin

 Locate the Internet Mail Service Extension included in the BackOffice 4.5 Resource Kit.  Register Internet Mail Service Extension by typing the following at the command prompt:

regsvr32 imsext.dll

 To enable Internet Mail Service Extension in Exchange Server 5.5 Service Pack 1 or later without losing routing table capability, you need to create a registry value:NOTE: Microsoft recommends the following method to enable Internet Mail Service Extension.

<ol style="list-style-type: lower-alpha;"> Start Registry Editor (Regedt32.exe).</li> Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIMC\Parameters

</li> On the Edit menu, click Add Value, and then add the following registry value:

Value Name: NonRoutingExtensionDll

Data Type: REG_SZ

String Value: The full path of the Internet Mail Service Extension utility DLL

You can also enable Internet Mail Service Extension in the Exchange Server Administrator program by opening the Internet Mail Service properties, clicking the Routing tab, and then selecting Internet Mail Service Extension as the custom routing program. IMPORTANT: Microsoft does not recommend this method. You will lose routing table capability.</li></ol> </li> Create an Extension registry key: <ol style="list-style-type: lower-alpha;"> Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIMC\Parameters

</li> On the Edit menu, click Add Key, and then type Extension .</li> Quit Registry Editor.</li></ol> </li></ol>

Inbound SMTP
To add prepended text to the body of an inbound Simple Mail Transfer Protocol (SMTP) message, create an InboundPrepend registry value: <ol> Start Registry Editor (Regedt32.exe).</li> Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIMC\Parameters\Extension

</li> On the Edit menu, click Add Value, and then add the following registry value:

Value Name: InboundPrepend

Data Type: REG_SZ

String Value: The text that you want to prepend to incoming messages.

</li> Quit Registry Editor.</li></ol>

To add appended text to the body of an inbound SMTP message, create an InboundAppend registry value: <ol> Start Registry Editor (Regedt32.exe).</li> Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIMC\Parameters\Extension

</li> On the Edit menu, click Add Value, and then add the following registry value:

Value Name: InboundAppend

Data Type: REG_SZ

String Value: The text that you want to append to incoming messages.

</li> Quit Registry Editor.</li></ol>

Outbound SMTP
To add prepended text to the body of an outbound SMTP message, create an OutboundPrepend registry value: <ol> Start Registry Editor (Regedt32.exe).</li> <li>Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIMC\Parameters\Extension

</li> <li>On the Edit menu, click Add Value, and then add the following registry value:

Value Name: OutboundPrepend

Data Type: REG_SZ

String Value: The text that you want to prepend to outgoing messages.

</li> <li>Quit Registry Editor.</li></ol>

To add appended text to the body of an outbound SMTP message, create an OutboundAppend registry value: <ol> <li>Start Registry Editor (Regedt32.exe).</li> <li>Locate the following key in the registry:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\MSExchangeIMC\Parameters\Extension

</li> <li>On the Edit menu, click Add Value, and then add the following registry value:

Value Name: OutboundAppend

Data Type: REG_SZ

String Value: The text that you want to append to outgoing messages.

</li> <li>Quit Registry Editor.</li></ol>

You must restart the Internet Mail Service for these changes to take effect. You must also restart the Internet Mail Service if you change the text string.

Additional query words: disclaimer

Keywords: kbhowto KB262097

-

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

© Microsoft Corporation. All rights reserved.