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.

Sections:

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

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::IO;
using namespace EAGetMail; //add EAGetMail namespace

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

    if (oMail->IsEncrypted)
    {
        try
        {
            // This email is encrypted, we decrypt it by user default certificate.
            // you can also use specified certificate like this
            // Certificate ^oCert = gcnew Certificate();
            // oCert->Load("c:\\test.pfx", "pfxpassword",
            //      Certificate::CertificateKeyLocation::CRYPT_USER_KEYSET);
            // oMail = oMail->Decrypt(oCert);
            oMail = oMail->Decrypt(nullptr);
        }
        catch (Exception ^ep)
        {
            Console::WriteLine(ep->Message);
        }
    }

    if (oMail->IsSigned)
    {
        try
        {
            // This email is digital signed.
            EAGetMail::Certificate ^signerCert = oMail->VerifySignature();
            Console::WriteLine("This email contains a valid digital signature.");

            // You can add the certificate to your certificate storage like this
            // signerCert->AddToStore(
            //      Certificate::CertificateStoreLocation::CERT_SYSTEM_STORE_CURRENT_USER,
            //      "addressbook");
            // then you can use send the encrypted email back to this sender.
        }
        catch (Exception ^ep)
        {
            Console::WriteLine(ep->Message);
        }
    }

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

    // Parse Mail To/Recipient
    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);
        // 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);
            }
        }
    }
}

int main(array<System::String ^> ^args)
{
    try
    {
        ParseEmail("c:\\my folder\\test.eml");
    }
    catch (Exception ^ep)
    {
        Console::WriteLine(ep->Message);
    }

    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::IO;
using namespace EAGetMail; //add EAGetMail namespace

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

    if (oMail->IsEncrypted)
    {
        try
        {
            // This email is encrypted, we decrypt it by user default certificate.
            // you can also use specified certificate like this
            // Certificate ^oCert = gcnew Certificate();
            // oCert->Load("c:\\test.pfx", "pfxpassword",
            //      Certificate::CertificateKeyLocation::CRYPT_USER_KEYSET);
            // oMail = oMail->Decrypt(oCert);
            oMail = oMail->Decrypt(nullptr);
        }
        catch (Exception ^ep)
        {
            Console::WriteLine(ep->Message);
        }
    }

    if (oMail->IsSigned)
    {
        try
        {
            // This email is digital signed.
            EAGetMail::Certificate ^signerCert = oMail->VerifySignature();
            Console::WriteLine("This email contains a valid digital signature.");

            // You can add the certificate to your certificate storage like this
            // signerCert->AddToStore(
            //      Certificate::CertificateStoreLocation::CERT_SYSTEM_STORE_CURRENT_USER,
            //      "addressbook");
            // then you can use send the encrypted email back to this sender.
        }
        catch (Exception ^ep)
        {
            Console::WriteLine(ep->Message);
        }
    }

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

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

    // Parse Mail To/Recipient
    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++)
    {
        Console::WriteLine("Attachment: {0}", atts[i]->Name);
    }
}

int main(array<System::String ^> ^args)
{
    try
    {
        ParseEmail("c:\\my folder\\test.eml");
    }
    catch (Exception ^ep)
    {
        Console::WriteLine(ep->Message);
    }

    return 0;
}

Next Section

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

Tutorial Index

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

Introduction¶

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

Parse TNEF (winmail.dat) by DecodeTNEF method¶

Share

See Also