Class for simple MAPI email


I needed the ability to create and send email from within my application (it’s an online trivia game called MindProbe). After messing around with the various OCX based solutions available I settled on a cut and paste of the code embedded deep within CDocument to access MAPI. I changed things a lot and abstracted it into it’s own class. This class handles multiple attached files as well as multiple recipients and multiple cc recipients.

This class only handles sending email – that’s all I needed at this stage. Usage couldn’t be easier.


This update fixes the problems noted with multiple recipients. It now copies the strings you pass rather than simply saving pointers to them.

I’ve also fixed the library reference count problem mentioned by one commentator.

#include <mapi.h>
#include "imapi.h"

void CBugReport::OnOK()
	 CIMapi  mail;

	 mail.To("[email protected]");				//  Set recipient name
	 mail.To("[email protected]");			//  Second recipient
	 mail.Cc("[email protected]");						//  CC recipient
	 mail.From("[email protected]"); 				//  Identify sender (not strictly necessary since MAPI will fill this in for you)
	 mail.Subject("Test Email");					//  Subject of this email
	 mail.Attach("somefilename");					//  Attaching a file
	 mail.Attach("someotherfile", "different_name_for_recipient");  //  Attach another file but give it a different name inside the email itself 

	 // Put text of message in body
	 mail.Text("Body text for this email"); 			//  Set body text
	 mail.Send();							//  Now send the mail! 


I used calloc(), realloc() and free() for memory allocation for the recipient and attachment lists. This is primarily because the corresponding members in the MAPI structures are pointers to arrays of structures and it didn’t make much sense to manipulate separate data structures simply to be ‘pure’ and stay within the confines of new and delete. In addition, I rely on the Microsoft C runtime library behaviour with regard to realloc() and free(). The library allows NULL pointers without causing errors – in the case of free() it simply returns; in the case of realloc() it treats a realloc() with a NULL pointer as though it was a calloc(). If your run time library behaves differently you may need to examine the code in the CIMapi destructor.

You need to have a default simple MAPI client defined on your system for this class to work. I use Outlook Express exclusively for my email and have it set as the default simple MAPI client.

Download source

More by Author

Previous articleCFileDialog Clone
Next articleA Super String Class

Must Read