Welcome, Guest Login

Support Centre

Enable RTF / TNEF support (using MAPI client objects)

Last Updated: Dec 03, 2013 12:11PM GMT


Since version 2.1 of mkryptor, it is possible to enable handling for Microsoft Rich Text Format / TNEF messages. To enable this support you will require the Microsoft MAPI objects installing on the same machine as your mkryptor SERVER installation.

If possible, it is still recommended that you disable RTF in Exchnage server (see here) or in Outlook (see here) if posible. This is due to general compatibility issues with any non-Microsoft mail client (i.e., many people cannot read RTF email - this is unrelated to mkryptor). If you do have a need to send messages in RTF / TNEF format, then follow this guide to enable mkryptor to understand the messages.

​Obtaining the Microsoft MAPI objects

The MAPI objects are included in the following Microsoft applications. If you already have one of these installed on the same machine as mkryptor SERVER then you should need to do nothing more (unless you are running 32 bit versions of these applications but running the 64 bit version of mkryptor (see below).
  • Exchange Server 2003
  • Microsoft Outlook 2003/2007/2010

32 or 64 bit?

It is important that you use the same "bitness" of MAPI objects as you have for mkryptor SERVER. I.e., if you're using the 64 bit version of mkryptor, then you'll need 64 bit MAPI objects (e.g, Outlook 2010 b4bit).

If you have MAPI objects of the incorrect bitness, you'll find errors such as the below appearing in your event log:

System.Runtime.InteropServices.COMException (0x800401FA): Wrong OS or OS version for application

​mkryptor 32 bit

If you are running the 32 bit version of mkryptor then you can either install a 32 bit version of Microsoft Outlook (which includes the MAPI objects), or you can download and install the free Microsoft Exchange Server MAPI Client and Collaboration Data Objects from this link.

After you have installed either of the above, restart the mkryptor service and you should find that it will now handle RTF / TNEF messages sucessfully

mkryptor 64 bit

Microsoft does not provide a standalone version of the MAPI objects for 64 bit. However 64 bit MAPI components are included with Microsoft Outlook 2010.

You can either install the full Outlook 2010 64 bit application, or it is also possible to install just the MAPI components from the install CD. To do this:
  • Run the Outlook 2010 64 bit installer. You may require a license key, but you do not need to activate the software to use the MAPI components.
  • Disable everything except Outlook MAPI Service Providers.
  • Complete the install.
  • Restart the mkryptor service and you should now have support for RTF / TNEF format messages.
seconds ago
a minute ago
minutes ago
an hour ago
hours ago
a day ago
days ago
Invalid characters found