Click here to Skip to main content
15,867,308 members
Articles / Mobile Apps

Sending mail using the Microsoft Windows CE Mail API

Rate me:
Please Sign up or sign in to vote.
5.00/5 (1 vote)
6 Jun 2002CPOL2 min read 148.1K   39   14
How to use the Microsoft Mail API to insert messages into the Window CE Outbox.

Preface

Please note this article outlines the development of mail software on platforms Pocket PC 2000 and older only. Pocket 2002 had significantly changed how mail is handled by the OS. I suggest you read the aricles available at the Pocket PC Developers Network

Introduction

Windows CE provides support for Email Storage as part of the core operating system (ie. its comes on the ROM chip). Microsoft provides a series of API's in the library 'msgstore.lib' which its calls Microsoft Mail API or MAPI. These API's allow the developer to manipulate the Systems Email Folders . Although these API's provide functionality to manipulate the Systems Email Folders and the Emails within those folders, no support has yet been provided for the sending and receiving of Email Messages. Microsoft assumes that the responsibility is upon the developer of the Email Client to provide these services.

//Includes
#include "msgstor2.h"
#include "msgstore.h"


CDummyMailClass::SendMail(CString csReciepent, CString csSubject, 
                          CString csBodyText, CString csAttachment)
{
    CTime      p_CurrentTime    = CTime::GetCurrentTime();
    SYSTEMTIME p_CurrentSystemTime;
    HANDLE     p_hMail          = NULL;    //This holds a Handle to our mail context
    BOOL       p_bReturn        = FALSE;
    MailMsg    p_MailMsg;


    //Open the mail context and return a handle to it
    p_bReturn = MailOpen(&p_hMail, TRUE)

        ASSERT(p_bReturn);

    if(!p_bReturn)
    {
        RptMailError(p_hMail);
    }

    //
    p_CurrentTime.GetAsSystemTime(p_CurrentSystemTime);

    memset(&p_MailMsg,0,sizeof(MailMsg));

    //A new message ID will assigned by the system when we call MsgPut
    p_MailMsg.dwMsgId=0;

    //Indicate that the mail is to be placed into the Outbox and its status 
    //is composed
    p_MailMsg.dwFlags=MAIL_FOLDER_OUTBOX | MAIL_STATUS_COMPOSED; 

    //Set up the time of sending as the current system time
    SystemTimeToFileTime(&p_CurrentSystemTime,&p_MailMsg.ftDate);

    //The service name as specify by msdn
    p_MailMsg.szSvcNam = _T("Windows CE Inbox Services");

    //The Messages body
    p_MailMsg.szBody = (LPTSTR) (LPCTSTR) csBodyText;


    p_bReturn = MailSetField ( &p_MailMsg, _T( "To" ), 
        (LPTSTR) (LPCTSTR) csReciepent );

    ASSERT(p_bReturn);

    p_bReturn = MailSetField ( &p_MailMsg, _T( "Subject" ),
        (LPTSTR) (LPCTSTR)  csSubject);

    ASSERT(p_bReturn);

    //Put the mail messages into the outgoing folder

    p_bReturn = MailPut ( p_hMail, &p_MailMsg);

    ASSERT(p_bReturn);


    //Close the handle to the open Mail Context, releasing the associated 
    //resources
    BOOL p_bReturn = MailClose(&p_hMail);

    ASSERT(p_bReturn);

}

Ok, so we have provided some basic functionality. However what is not immediately evident is that the above code, places any messages it creates into the Activesync Outbox. Under Windows CE the Mail Folders are Hierarchical, the standard mail folders; inbox, outbox, deleted, etc are created below a root folder. Whenever a mail client (in most cases Microsoft Outlook) configures a new Transport, it will also create a new root folder and subfolders to hold messages for that transport. A newily installed Windows CE system comes with the ActiveSync transport already installed and configured (send and recieving of mail via a desktop pc) and then the user can configure other transports, such as IMAP or SMTP. So therefore let us assume that our application needs to send Mail via Simple Mail Transport Protocol (SMTP), therefore all our new messages need to be placed in the SMTP 'Outbox'.

FID    p_ParentFolderId;
FID    p_FolderId;

//Get The Folder Id of the Root Folder for the SMTP transport
p_bReturn = MailGetFolderIdEx(p_hMail, MAIL_FOLDER_NONE, 
                              &p_ParentFolderId, _T("POP3 Mail"));

ASSERT(p_bReturn);

//Get the Folder Id of the Child Folder Outbox
p_bReturn = MailGetFolderIdEx(p_hMail, p_ParentFolderId, &p_FolderId, 
                              _T("Outbox"));

ASSERT(p_bReturn);

//Specify the into folder which the new mail is be put.
p_bReturn = MailPutEx ( p_hMail, &p_MailMsg, p_FolderId );

ASSERT(p_bReturn);

So lets add some more functionality. Application will often wish to attach files to Emails they are sending. Please note, any files you attach to Emails will be automatically deleted by the API.

MailAtt p_MailAttachment;
BOOL    p_bReturn;

memset(&p_MailAttachment, 0, sizeof(MailAtt));

// Setup the Mail Attachment Structure
//This must be incremented for every new attachment to a mail
p_MailAttachment.uiAttachmentNumber = 1;
p_MailAttachment.dwFlags = NULL;
// Not needed since we are sending a local file
p_MailAttachment.ulSize = NULL;
//The Orignal File Name (the file without the path)
p_MailAttachment.szOriginalName = (LPTSTR) (LPCTSTR) p_csFileName;
//The full path to the file
p_MailAttachment.szLocalName = (LPTSTR) (LPCTSTR) csAttachment;

p_bReturn = MailPutAttachment(p_hMail, &p_MailMsg, &p_MailAttachment);

ASSERT(p_bReturn);

A final word on Error Handling. The Mail API also provides fairly comprehensive error information, this can be accessed through the MailError* API calls.

INT        p_iBufferLength    = 100;
INT        p_iLineNumber    = 0;
CString    p_csErrorMsg;

MailErrorMsg (p_hMail , p_csErrorMsg.GetBuffer(p_iBufferLength), 
              p_iBufferLength, &p_iLineNumber);

p_csErrorMsg.ReleaseBuffer();

AfxMessageBox(p_csErrorMsg, MB_OK|MB_ICONSTOP);

For more information please see the MSDN article Using the Microsoft Windows CE Mail API . As I have said the Mail API is limited in that it doesn't actually send the Email. If this functionality is required a 'smtp.dll' is provided on the ROM, and is used by 'Outlook' to send Email via SMTP. Information on this library is not provided by Micrsoft, however its Exports are listed in the header 'msgxport.h'. Ray Kinsella

Any problems or question feel free to query me at

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Web Developer
Ireland Ireland
A very confused human being, a slightly less confused developer.

Comments and Discussions

 
QuestionHow to intercept outgoing SMS message in VC++? Pin
drugs_taker5-Dec-08 23:04
drugs_taker5-Dec-08 23:04 
Generalabout sending mail Pin
Member 374400219-Jan-07 23:06
Member 374400219-Jan-07 23:06 
Generaldownload the e-mails Pin
PoperoH15-Sep-04 10:45
PoperoH15-Sep-04 10:45 
I have used this article to make my program create a e-mail message on the outbox of the windows ce, it works just fine, either the part to read messages on the inbox, but now I having the following problem: how to make the windows ce receive and send the messages from the pop3 and smtp server??
GeneralRe: download the e-mails Pin
Anonymous15-Sep-04 23:13
Anonymous15-Sep-04 23:13 
GeneralRe: download the e-mails Pin
Ray Kinsella15-Sep-04 23:14
Ray Kinsella15-Sep-04 23:14 
GeneralRe: download the e-mails Pin
vikas amin22-Sep-05 0:50
vikas amin22-Sep-05 0:50 
Questionhow to use cemapi in inbox ? Pin
shenhow22-Jul-03 4:18
shenhow22-Jul-03 4:18 
QuestionDrafts instead of Outbox? Pin
Wowik26-Aug-02 1:56
Wowik26-Aug-02 1:56 
GeneralMail API for Pocket PC Pin
Osnat18-Apr-02 0:41
Osnat18-Apr-02 0:41 
GeneralRe: Mail API for Pocket PC Pin
EK_Kiwi17-Jun-03 10:30
EK_Kiwi17-Jun-03 10:30 
GeneralMAPI Send mail Pin
kolmol21-Mar-02 23:50
kolmol21-Mar-02 23:50 
GeneralSIM Manager API Pin
18-Feb-02 19:34
suss18-Feb-02 19:34 
Questionhow to expose Pocket PC 2002 API's in eVB Pin
14-Feb-02 1:04
suss14-Feb-02 1:04 
AnswerRe: how to expose Pocket PC 2002 API's in eVB Pin
purushdeo28-Jan-03 10:07
purushdeo28-Jan-03 10:07 

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

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