Imap4Example: -An Email manager using IMAP4 and SMTP

Description

This -example application demonstrates how to create SMTP (Simple Mail Transfer -Protocol) and IMAP (Internet Message Access Protocol) accounts to send and -receive emails respectively. The application creates dummy messages and sends -them using SMTP.

The application starts a session with the messaging -server using CMsvSession::OpenSyncL() and gets an instance -of the client MTM (Message Type Module) registry using CClientMtmRegistry::NewL(). -Using this registry it creates IMAP4 client-side MTM objects for the specified -UID.

After creating the client MTM objects, the application creates -IMAP4 and SMTP accounts using CEmailAccounts::CreateImapAccountL() and CEmailAccounts::CreateSmtpAccountL() respectively. -Settings and preferences for these accounts are configured using the CImImap4Settings, CImIAPPreferences and CImSmtpSettings.

A simple SMTP message is created by the -application using the CImEmailOperation::CreateNewL() function, -and then sent to the email address stored in the literal KTo.

Note: -Each email account created by the application has a pair of service entries, -which are used to store settings required for email transport.

The -application also provides the CMessAsyncWaiter class to issue -asynchronous requests to the messaging server and handles completed requests. -This class implements the CActive abstract interface.

Download

Click -on the following link to download the example: Imap4Example.zip

Click: browse to view the example code.

Pre-requisites

A -null modem cable (NTRAS - New Technology Remote Access Services) must be connected -to your system for the example to be functional. Also, change the values of -literals KSmtpServerAddress and KImapServer defined -in the imap4example.cpp file to your system address.

In -addition to the above mentioned changes, you must have an account with the -messaging server. You can create an account using any messaging proxy server -application such as Communigate-Pro, which is freely downloadable from http://www.stalker.com/CommuniGatePro/. -The name of the newly created account can either be the account name used -by the application or a different one. If you choose to name the new account -different from the account name used by the application, change the value -of the literal KImapLoginName defined in the imap4example.cpp file -to the new account name.

Note: To check the messages sent -by the application, you must configure your email client to retrieve messages -for the newly created IMAP4 account. For information on how to configure your -email client, refer its user guide.

Class Summary

CEmailAccounts

MMsvSessionObserver

TMsvSessionEvent

CClientMtmRegistry

CMsvSession

CBaseMtm

CMsvOperation

TMsvId

TImapAccount

TSmtpAccount

CActive

Build

The Symbian OS build process describes -how to build an application.

The IMAP4 example builds an executable -called impa4Example.exe in the standard location (\epoc32\release\winscw\ <build_variant> for -CodeWarrior). After launching the executable, depending on the emulator you -are using, you may need to task away from the app launcher/shell screen to -view the console.