Parse winmail.dat (TNEF/MAPI) in C++/CLI/CLR

In previous section, I introduced how to verify digital signature and decrypt email. In this section, I will introduce how to parse winmail.dat (TNEF stream) in C++/CLI/CLR.

Introduction

When an Outlook user composes and sends a message using either Rich Text Format or HTML Format, Outlook automagically generates a file, winmail.dat, and attaches it to the end of the email. The winmail.dat contains the rich text body and original attachments. To parse winmail.dat (TNEF stream) file, we should use ParseTNEF method.

Note

Remarks: All of examples in this section are based on first section: A simple C++/CLI/CLR project. To compile and run the following example codes successfully, please click here to learn how to create the test project and add reference to your project.

[C++/CLI/CLR Example - Parse winmail.dat (TNEF stream)]

The following example codes demonstrate how to parse MAPI winmail.dat.

Note

To get the full sample projects, please refer to Samples section.

#include "stdafx.h"

using namespace System;
using namespace System::Text;
using namespace System::Collections;
using namespace System::IO;
using namespace EAGetMail; //add EAGetMail namespace

void ParseEmail(String ^emlFile)
{
    Mail ^oMail = gcnew Mail("TryIt");
    oMail->Load(emlFile, false);

    // Parse Sender
    Console::WriteLine("From: {0}", oMail->From->ToString());

    // Parse Mail To
    array<MailAddress^> ^addrs = oMail->To;
    for (int i = 0; i < addrs->Length; i++)
    {
        Console::WriteLine("To: {0}", addrs[i]->ToString());
    }

    // Parse Mail CC
    addrs = oMail->Cc;
    for (int i = 0; i < addrs->Length; i++)
    {
        Console::WriteLine("To: {0}", addrs[i]->ToString());
    }

    // Parse Mail Subject
    Console::WriteLine("Subject: {0}", oMail->Subject);

    // Parse Mail Text/Plain body
    Console::WriteLine("TextBody: {0}", oMail->TextBody);

    // Parse Mail Html Body
    Console::WriteLine("HtmlBody: {0}", oMail->HtmlBody );

    //Parse Attachments
    array<Attachment^> ^atts = oMail->Attachments;
    for (int i = 0; i < atts->Length; i++)
    {
        Attachment ^att = atts[i];

        // This attachment is in OUTLOOK RTF format(TNEF), decode it here.
        if (String::Compare(att->Name, "winmail.dat") == 0)
        {
            array<Attachment^> ^tatts = nullptr;
            try
            {
                tatts = Mail::ParseTNEF(att->Content, true);
            }
            catch (Exception ^ep)
            {
                Console::WriteLine(ep->Message);
                continue;
            }
            int y = tatts->Length;
            for (int x = 0; x < y; x++)
            {
                Attachment ^tatt = tatts[x];
                Console::WriteLine("winmail.dat: {0}", tatt->Name);
            }
            continue;
        }

        Console::WriteLine("Attachment: {0}", atts[i]->Name);
    }
}

int main(array<System::String ^> ^args)
{
    // Create a folder named "inbox" under current directory
    // to save the email retrieved.
    String ^curpath = Directory::GetCurrentDirectory();
    String ^mailbox = String::Format("{0}\\inbox", curpath);

    // If the folder is not existed, create it.
    if (!Directory::Exists(mailbox))
    {
        Directory::CreateDirectory(mailbox);
    }

    // Get all *.eml files in specified folder and parse it one by one.
    array<String^> ^files = Directory::GetFiles(mailbox, "*.eml");
    for (int i = 0; i < files->Length; i++)
    {
        ParseEmail(files[i]);
    }

    return 0;
}

Parse TNEF (winmail.dat) by DecodeTNEF method

In EAGetMail 4.5, a new method named DecodeTNEF is introduced. It is easier to parse TNEF attachment. Please have a look at the following example codes:

#include "stdafx.h"

using namespace System;
using namespace System::Text;
using namespace System::Collections;
using namespace System::IO;
using namespace EAGetMail; //add EAGetMail namespace

void ParseEmail(String ^emlFile)
{
    Mail ^oMail = gcnew Mail("TryIt");
    oMail->Load(emlFile, false);

    // Decode winmail.dat (TNEF) and RTF body automatically
    oMail->DecodeTNEF();

    // Parse Sender
    Console::WriteLine("From: {0}", oMail->From->ToString());

    // Parse Mail To
    array<MailAddress^> ^addrs = oMail->To;
    for (int i = 0; i < addrs->Length; i++)
    {
        Console::WriteLine("To: {0}", addrs[i]->ToString());
    }

    // Parse Mail CC
    addrs = oMail->Cc;
    for (int i = 0; i < addrs->Length; i++)
    {
        Console::WriteLine("To: {0}", addrs[i]->ToString());
    }

    // Parse Mail Subject
    Console::WriteLine("Subject: {0}", oMail->Subject);

    // Parse Mail Text/Plain body
    Console::WriteLine("TextBody: {0}", oMail->TextBody);

    // Parse Mail Html Body
    Console::WriteLine("HtmlBody: {0}", oMail->HtmlBody );

    //Parse Attachments
    array<Attachment^> ^atts = oMail->Attachments;
    for (int i = 0; i < atts->Length; i++)
    {
        Attachment ^att = atts[i];
        Console::WriteLine("Attachment: {0}", atts[i]->Name);
    }
}

int main(array<System::String ^> ^args)
{
    // Create a folder named "inbox" under current directory
    // to save the email retrieved.
    String ^curpath = Directory::GetCurrentDirectory();
    String ^mailbox = String::Format("{0}\\inbox", curpath);

    // If the folder is not existed, create it.
    if (!Directory::Exists(mailbox))
    {
        Directory::CreateDirectory(mailbox);
    }

    // Get all *.eml files in specified folder and parse it one by one.
    array<String^> ^files = Directory::GetFiles(mailbox, "*.eml");
    for (int i = 0; i < files->Length; i++)
    {
        ParseEmail(files[i]);
    }

    return 0;
}

Next Section

At next section I will introduce how to convert email to HTML page and display it in Web browser.

Appendix

Comments

If you have any comments or questions about above example codes, please click here to add your comments.