Click here to Skip to main content
11,706,799 members (45,514 online)
Click here to Skip to main content

Sending Email using MAPI - A COM DLL

, 29 May 2003 253.6K 6.8K 65
Rate this:
Please Sign up or sign in to vote.
How to automatically send customized emails messages and attachments?

Sample Image - TestEmail.jpg

Introduction

During the software development, I have seen many applications that requires incorporating email support. I remember, once I was to develop an application, which sends emails at the specific time to specific people with the customized messages. For that I developed a COM service that used MAPI. MAPI, i.e. Messaging Application Programming Interface, is the standard messaging architecture and a complete set of functions and object-oriented interfaces. Here I have an Email component, a COM DLL, which is a set of messaging functions that helps you create messaging-enabled applications. This COM component uses Simple MAPI to achieve that.

Note: MAPI is used by various industry-standard e-mail clients, such as the Microsoft Exchange client, all versions of Microsoft Outlook and Outlook Express, including QUALCOMM Incorporated (Eudora) and Netscape Communications Corporation. So you can use this component with these client applications also.

Component Design

The CLSID of the Email component is CLSID_Mail and it has only one interface IMail with the interface ID IID_IMail.

CMail is the implementation class and contains following data members:

m_MAPILogon Function pointer for MAPILogon
m_MAPISendMail Function pointer for MAPISendMail
m_MAPISendDocuments Function pointer for MAPISendDocuments
m_MAPIFindNext Function pointer for MAPIFindNext
m_MAPIReadMail Function pointer for MAPIReadMail
m_MAPIResolveName Function pointer for MAPIResolveName
m_MAPIAddress Function pointer for MAPIAddress
m_MAPILogoff Function pointer for MAPILogoff
m_MAPIFreeBuffer Function pointer for MAPIFreeBuffer
m_MAPIDetails Function pointer for MAPIDetails
m_MAPISaveMail Function pointer for MAPISaveMail

IMail have the following functions:

IsMapiInstalled Checks if the MAPI is installed on the system. It searches Win.INI file for the MAPI key. If found it returns S_OK.
InitMapi After checking the through IsMapiInstalled, it initializes the MAPI function pointers. Method should be called once before using the component.
put_strProfileName Takes the name of the outlook profile name you are using to send the email.
put_strEmailAddress Sets the recipient email address. You can specify more than one comma (,) separated recipient addresses.
put_strRecipient Sets the name you want to specify for the recipients, sets the email names of the sender – it may be different from your specified profile email address.
put_strSubject Sets the subject of the email.
get_strSubject Returns the email subject.
put_strMessage Sets email message text.
get_strMessage Returns message text.
put_strAttachmentFilePath Sets the email attachment with the full path like “c:\abc.txt”.
get_strAttachmentFilePath Returns the path of email attachment.
put_strAttachmentFile The display name of the attachment (Sample.txt), by default, it’s the same as that specified in put_strAttachmentFilePath.
get_strAttachmentFile Returns the attachment file name.
Logon Opens a new logon session if not already opened, using specified outlook profile, name and the profile password, you must logon before sending the email. I have set password to NULL assuming that the profile you will specify have NO password, but you can specify your own password. Automatically called by Send method.
Logoff Logs off, and closes the session. Automatically called by Send method after sending the email.
Send Sends the email, requires valid outlook profile name, recipient email address and a login session to send email.

Steps to execute the demo project

The demo project demonstrates the way you can use the component to send an email. In order to execute the demo project, the following settings are required:

Step 1: You must have some valid Output Express email account or create one named TestProfile.

You can create an email profile in Express from Tools>Accounts menu. This will open Internet Accounts property sheet. On the tab All, click the button Add and then Mail. A wizard will let you create an email account, specify the valid email address. For hotmail account, wizard automatically sets the names of email servers.

Sample Image- Account

After successfully creating the account, select the account name from the list in All tab (for hotmail account, the default account name is Hotmail). Open account properties by pressing Properties button and change the account name from default name (say Hotmail) to TestProfile.

Sample Image

Step 2: Register the DLL

All COM DLLs required to be registered. After copying the DLL source code, you can register the DLL by right clicking the DLL and selecting Register DLL or Register COM component option, or simply by double clicking the DLL. Compiling the DLL code in Visual Studio will automatically register the DLL.

Step 3: Logged on to the net

Make sure you are logged on to the net. If not, outlook will fail to deliver the email, however, you can still check the composed email in your outbox.

How to send email?

After specifying the information in the dialog box, click the Send button. A warning message will be displayed, click Send button.

Warning

Note:The warning dialog is displayed because of the security constraints. If you want to get rid of this dialog box, then you will have to use Extended MAPI instead of simple MAPI.

Sending

Here is the method CTestEmailDlg::OnSend method, which is used to pass the user specified information to the email object and call the IMail::Send method after setting everything.

//##//##//////////////////////////////////////////////////////////////

///////////////////////////////////////////////
//
//  void CTestEmailDlg::OnSend() 
//
//    This module is called when send button is pressed and uses 
//Email COM DLL to send 

email - Aisha Ikram
// Note: dont forget to initialize COM library using CoInitialize(NULL);
//##//##////////////////////////////////////////////////////////////////////

///////////////////////////////////////////////

void CTestEmailDlg::OnSend() 
{
  UpdateData();
  try{
       
    CComPtr<IMAIL> objMail;
        
    HRESULT hr;
    // make sure the DLL is registered
    hr = objMail.CoCreateInstance(CLSID_Mail);
    if(SUCCEEDED(hr))
    {
      if(hr== S_OK)
      {
        // profile name is compulsory, this is the outlook profile, 
        // i used "outlook express" as configuring it is easier than 
       // "MS outlook" make sure to specify the correct sender's address 
       // for this profile and make sure that outlook express is 
       //the default email client.
    
       if(m_strProfile.IsEmpty())
       {    
         AfxMessageBox("Please specify email profile name ");
         return;    
       }
                
       if(m_strTo.IsEmpty())
       {
         AfxMessageBox("Please specify recipient's email address ");
         return;
       }
       // by default, it's TestProfile, assumes that a profile with this 
       //name exists in outlook
       hr= objMail->put_strProfileName((_bstr_t)m_strProfile);
                
       hr = objMail->put_strSubject((_bstr_t)m_strSubject);
                
       // this is the email or set of email addresses (separated by ,)
       // which is actually used to send email            
       hr = objMail->put_strEmailAddress((_bstr_t)m_strTo);
                
       // recipient is just to show the display name
       hr = objMail->put_strRecipient((_bstr_t)m_strTo);
                
       hr = objMail->put_strAttachmentFilePath((_bstr_t)m_strAttachment);
                
       hr = objMail->put_strMessage((_bstr_t)m_strMessage);

       hr= objMail->Send();

       if(hr!=S_OK)
         AfxMessageBox("Error, make sure the info is correct");
       }//if
     } //if
   } // try
   catch(...)
   {
     AfxMessageBox("Error, make sure specified info is correct");
   }
}

Check the mail in the recipient inbox.

New Msg

Where to use

This component can be extended to incorporate the functionalities like opening an existing inbox to read emails automatically from the inbox and composing new emails etc. It can be used to send emails automatically with customized user messages and attachments to specific people at particular time, especially while using some exe servers or NT services.

That's it. If there is any suggestions or comments you are most welcome. Your rating would help me evaluate the standard of my article.

Looking for a Class instead of a COM component?

I have also build a class CSMAPI, to use simple MAPI to send email, read and find a message and more is to be added. You can find this class, which you can use anywhere (either in win32, or MFC or ATL) and the demo project in MFC.

You can find all at my website (free code and articles website).

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

Aisha Ikram
Team Leader
United Kingdom United Kingdom
I am currently working as a Technical Lead in a software house in UK. I am Master in Science in Computer Science. I worked in .NET 1.1/2.0, C#, VB.NET, ASP.NET, VC++ 6, MFC, ATL, COM/DCOM, SQL Server 2000/2005. These days i am learning all .Net 3.x stuff. My free source code and articles website at http://aishai.netfirms.com

You may also be interested in...

Comments and Discussions

 
GeneralWithout user interaction Pin
Zoltan16-Feb-10 7:48
memberZoltan16-Feb-10 7:48 
Questionhelp me to eleminate confim message of windows mail by using mapi Pin
praswani@indiatimes.com26-Apr-09 20:52
memberpraswani@indiatimes.com26-Apr-09 20:52 
GeneralVista "Windows Mail" Pin
Member 259584526-May-08 12:29
memberMember 259584526-May-08 12:29 
GeneralRe: Vista "Windows Mail" Pin
xirc_za4-Oct-08 10:56
memberxirc_za4-Oct-08 10:56 
GeneralRe: Vista "Windows Mail" Pin
Member 259584517-Dec-08 7:51
memberMember 259584517-Dec-08 7:51 
GeneralSending Mail on a different Thread in C# with Attachments Pin
Riaz Afridi25-Jul-07 14:31
memberRiaz Afridi25-Jul-07 14:31 
GeneralThanks Pin
Member #345787918-Mar-07 4:51
memberMember #345787918-Mar-07 4:51 
GeneralSending mail using Simple MAPI Pin
kunal.tawde27-Feb-07 18:13
memberkunal.tawde27-Feb-07 18:13 
GeneralSending Mail using MAPI doesn't work with MS Outlook. Pin
kunal.tawde26-Feb-07 23:55
memberkunal.tawde26-Feb-07 23:55 
GeneralSending a Email without user's intervention Pin
venki.v21-Sep-06 1:06
membervenki.v21-Sep-06 1:06 
GeneralSample heading Pin
Shahid_2k_whiz13-Jul-06 23:52
memberShahid_2k_whiz13-Jul-06 23:52 
Generalnice job Pin
ivan françois29-Mar-06 21:59
memberivan françois29-Mar-06 21:59 
GeneralRe: nice job Pin
Aisha Sarfraz2-Apr-06 23:48
memberAisha Sarfraz2-Apr-06 23:48 
GeneralThank you Pin
Pablo Aliskevicius6-Mar-06 20:12
memberPablo Aliskevicius6-Mar-06 20:12 
QuestionRegarding folders of all the identities in outlook express Pin
rajeevktripathi22-Nov-05 1:55
memberrajeevktripathi22-Nov-05 1:55 
Generalinternet status Pin
Kutti Ra30-Sep-05 16:14
memberKutti Ra30-Sep-05 16:14 
GeneralMultiple recipients Pin
angeltsoi19-Jul-05 22:26
memberangeltsoi19-Jul-05 22:26 
GeneralRe: Multiple recipients Pin
Member 180440317-Aug-11 4:39
memberMember 180440317-Aug-11 4:39 
Generalsignatures are not sent! Pin
schaereran@gmx.net20-Apr-04 23:44
memberschaereran@gmx.net20-Apr-04 23:44 
Generalit giving me login failure message when i debug Pin
Rajesh match1-Apr-04 23:04
memberRajesh match1-Apr-04 23:04 
GeneralMapi ResolveName Fail. Result = -2147467259 Pin
Anonymous10-Mar-04 11:51
sussAnonymous10-Mar-04 11:51 
GeneralChoosing Profile make no difference Pin
Ripal Vaidya29-Jan-04 18:54
memberRipal Vaidya29-Jan-04 18:54 
Generalregistering dll Pin
halwas24-Dec-03 4:24
memberhalwas24-Dec-03 4:24 
GeneralRe: registering dll Pin
halwas24-Dec-03 5:09
memberhalwas24-Dec-03 5:09 
GeneralRe: registering dll Pin
shital_harode@rediffmail.com20-Nov-06 18:47
membershital_harode@rediffmail.com20-Nov-06 18:47 
Generalregistering the dll Pin
Anonymous24-Dec-03 4:18
sussAnonymous24-Dec-03 4:18 
Questionhow to read messages from inbox Pin
jerko17-Oct-03 2:08
memberjerko17-Oct-03 2:08 
GeneralOutlok Express MapiSendMail Pin
jmh2770ca29-Sep-03 11:31
memberjmh2770ca29-Sep-03 11:31 
GeneralExtended MAPI Pin
xxhimanshu16-Jul-03 20:29
memberxxhimanshu16-Jul-03 20:29 
GeneralRe: Extended MAPI Pin
Aisha Ikram16-Jul-03 20:50
memberAisha Ikram16-Jul-03 20:50 
GeneralRe: Extended MAPI Pin
xxhimanshu16-Jul-03 22:39
memberxxhimanshu16-Jul-03 22:39 
GeneralRe: Extended MAPI Pin
baw29-May-04 10:25
memberbaw29-May-04 10:25 
GeneralRe: Extended MAPI Pin
Aisha Ikram30-May-04 19:04
memberAisha Ikram30-May-04 19:04 
GeneralRe: Extended MAPI Pin
Draculea525-Jan-05 22:37
sussDraculea525-Jan-05 22:37 
GeneralRe: Extended MAPI Pin
AndiLF9992-Oct-05 17:43
sussAndiLF9992-Oct-05 17:43 
QuestionAnyone know how to use MAPI in service ? Pin
zhangfei30-May-03 9:04
memberzhangfei30-May-03 9:04 
AnswerRe: Anyone know how to use MAPI in service ? Pin
thikone2-Oct-04 10:42
memberthikone2-Oct-04 10:42 
GeneralNice but ... Pin
Anonymous29-May-03 21:18
sussAnonymous29-May-03 21:18 
GeneralRe: Nice but ... Pin
TeaShirt30-May-03 4:50
memberTeaShirt30-May-03 4:50 
GeneralRe: Nice but ... Pin
hannahb12-Jul-06 9:57
memberhannahb12-Jul-06 9:57 
GeneralDo you Know.. Pin
Mazdak8-May-03 7:20
memberMazdak8-May-03 7:20 
GeneralRe: Do you Know.. Pin
Aisha Ikram9-May-03 1:10
memberAisha Ikram9-May-03 1:10 
GeneralRe: Do you Know.. Pin
Mazdak1-Jun-03 7:48
memberMazdak1-Jun-03 7:48 
GeneralHelp needed Pin
norbland21-Apr-03 0:59
membernorbland21-Apr-03 0:59 
GeneralEmail src Pin
norbland17-Apr-03 4:46
membernorbland17-Apr-03 4:46 
GeneralRe: Email src Pin
Aisha Ikram17-Apr-03 18:22
memberAisha Ikram17-Apr-03 18:22 
GeneralRe: Email src Pin
norbland18-Apr-03 1:08
membernorbland18-Apr-03 1:08 
GeneralRe: Email src Pin
Aisha Ikram18-Apr-03 1:22
memberAisha Ikram18-Apr-03 1:22 
GeneralRe: Email src Pin
norbland21-Apr-03 1:00
membernorbland21-Apr-03 1:00 
GeneralEmail Accounts Pin
kolo83a21-Mar-03 20:49
memberkolo83a21-Mar-03 20:49 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web04 | 2.8.150819.1 | Last Updated 30 May 2003
Article Copyright 2002 by Aisha Ikram
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid