This tutorial introduces how to retrieve email and parse email in Visual C++ using POP3/IMAP4/EWS/WebDAV protocol. It also demonstrates retrieving email over SSL/TLS connection, verifying email digital signature, decrypting encrypted email (S/MIME), parsing email attachment, parsing non-delivery report (NDR) and managing mail folder.
- Mail Pilot 3 0 (5244) – Task Oriented Email Clients
- Mail Pilot 3 0 (5244) – Task Oriented Email Client Login
- Mail Pilot 3 0 (5244) – Task Oriented Email Client Asks
- Mail Pilot 3 0 (5244) – Task Oriented Email Client Example
Sections: Capo 3 8 12.
Mail Pilot is an email client for MacOS polished offering a simple but powerful feature along with a modern user interface. The client adopts a simplified software email client, unlike traditional using indicators and complicated configurations approach. Mail Pilot lets you send emails from all accounts to different places. In other words, you can sort. Popular email client Mail Pilot treats each message as a task to be checked off your to-do list. Mail Pilot 2, launching Thursday for iPhone and iPad, aims to further increase your productivity.
Mail Pilot 2, the Mac Email Client, Enters Free Beta. Mac: Mail Pilot’s an admirable email app for iOS that turns your emails into to-dos, and if you want to check it out on OS X, you can do. My favorite thing about Mail Pilot is their overall approach to e-mail. It is just a to-do list, there is no more read/unread. Since using Mail Pilot over the last year, I find myself reaching the fabled inbox zero multiple times per week, whereas I don't believe I ever achieved that milestone in the years prior.
Retrieve email in a simple Visual C++ project¶
To better demonstrate how to retrieve email and parse email, let’s createa Visual C++ console project named “receiveemail” at first, and then add the reference ofEAGetMail in your project.
Installation¶
EAGetMail is a POP3 and IMAP4 component which supports all operations of POP3/IMAP4/MIME/ExchangeWeb Service/WebDAV/SSL/S/MIME protocol. Before you can use the following example codes, you shoulddownload the EAGetMail Installerand install it on your machine at first. Full sample projects are included in this installer.
Add Reference¶
To use EAGetMail POP3 & IMAP4 ActiveX Object in your project, the first step is “Add header files of EAGetMail to your project”.Please go to
C:ProgramFilesEAGetMailIncludetlh
or C:ProgramFiles(x86)EAGetMailIncludetlh
folder, find eagetmailobj.tlh
and eagetmailobj.tli
,and then copy these files to your project folder. You can start to use it to retrieve email and parse email in your project.[Visual C++ Example - Retrieve email from POP3 server]¶
Now add the following codes to the project. The following codes demonstrate howto retrieve email from a POP3 mail account. It downloads emails from POP3server and deletes the email after the email is retrieved.
In order to run it correctly, please change
emailserver
, user
, password
, folder
, filename
values.If you set everything right, you can get emails in the mail folder. If the codesthrew exception, then please have a look at the following section.
Where can I get my POP3 server address, user and password?¶
Because each email account provider has different server address, so you shouldquery your POP3 server address from your email account provider. User name is youremail address or your email address without domain part. It depends on your emailprovider setting.
When you execute above example code, if you get error about “Networking connection”or “No such host”, it is likely that your POP3 server address is not correct.If you get an error like “Invalid user or password”, it is likely that youdid not set the correct user or password.
Finally, if you have already set your account in your email client such as Outlookor Window Mail, you can query your POP3 server address, user in your email client.For example, you can choose
menu
-> Tools
-> Accounts
-> Youremailaccount
-> Properties
-> Servers
in Outlook express or Windows Mailto get your POP3 server, user. Using EAGetMail to receive email does not requireyou have email client installed on your machine or MAPI, however you can query yourexist email accounts in your email client.![Mail Pilot 3 0 (5244) – Task Oriented Email Client Mail Pilot 3 0 (5244) – Task Oriented Email Client](https://img.magimg.com/uploads/mail-pilot.png)
Troubleshooting¶
Charles android. When you retrieve email in above simple project, if it returned an error, please have a look at the following tips:
“No Such Host” Error¶
This error means DNS server cannot resolve POP3 server, you should check if you input correct server address. If your server address is correct, you should check if your DNS server setting is correct.
Common “Socket/Networking Connection” Error¶
This error means there is a problem with networking connection to POP3 server. You can use Windows built-in Telnet command to detect the networking connection.
Using Telnet to detect networking connection to POP3 server¶
Mail Pilot 3 0 (5244) – Task Oriented Email Clients
Note
Notice: in Windows 2008/Windows 8 or later version, Telnet Client is not installed by default, you should enable this command in
ControlPanel
-> ProgramsandFeatures
-> TurnWindowsfeatureonoroff
-> have TelnetClient
checked.Under DOS command prompt, input
telnet[serveraddress][port]
If the networking connection to your POP3 server is good, it should return a message like
+OK..
.If it returns Couldnotopenconnectionto..
, that means the networking connection to POP3 server is bad,or outbound 110 port is blocked by anti-virus software, firewall or ISP.Please have a look at the following screenshot:POP3 110, 995 port, IMAP4 143, 993 port and SSL¶
- 110 port is the default POP3 server port to receive email. 995 port is the common POP3 SSL port used to receive email over implicit SSL connection.
- 143 port is the default IMAP4 server port, 993 port is the common port for IMAP4 SSL.
If you use telnet to test 995/993 port, it doesn’t return the
+OK..
, because it requires SSL hand shake.If the connection is ok, telnet returns a flash cursor.Now SSL is commonly used, many email servers require SSL connection such as Gmail, Outlook, Office 365 and Yahoo.In this case you should set
MailServer.SSLConnection
to true
and change MailServer.Port
to 995 (POP3) or 993 (IMAP4).“-ERR user authentication” Error¶
This error means user authentication is failed, you should check whether you input correct user/password. Password is always case-sensitive.
![Task Task](https://is4-ssl.mzstatic.com/image/thumb/Purple49/v4/fa/fc/18/fafc1852-b858-f033-6ae6-5ada09079782/pr_source.jpg/1280x0w.jpg)
Other error returned by POP3 server¶
If POP3 server returns an error, it usually returns description about this error. You can use the following codes to generate a log file to learn all POP3 session between client and server.
Mail Pilot 3 0 (5244) – Task Oriented Email Client Login
[Visual C++ - Using log file to detect POP3 server response - Example]
TLS 1.2¶
TLS is the successor of SSL, more and more Email servers require TLS 1.2 encryption now.
If your operating system is
WindowsXP/Vista/Windows7/Windows2003/2008/2008R2/2012/2012R2
,and you got connection error with SSL/TLS connection,you need to enable TLS 1.2 protocol in your operating system like this:32bit/x64 ActiveX DLL¶
Seperate builds of run-time dll for 32 and x64 platform
File | Platform |
Installation PathLibnativex86EAGetMailObj.dll | 32 bit |
Installation PathLibnativex64EAGetMailObj.dll | 64 bit |
Mail Pilot 3 0 (5244) – Task Oriented Email Client Asks
Distribution¶
- Standard EXEFor VB6, C++, Delphi or other standard exe application, you can distribute EAGetMailObj.dll with your application to target machine without COM-registration and installer.To learn more detail, please have a look at Registration-free COM with Manifest File.
- ScriptFor ASP, VBScript, VBA, MS SQL Stored Procedure, you need to install EAGetMail on target machine by EAGetMail installer, both 32bit/x64 DLL are installed and registered.
Next Section
Mail Pilot 3 0 (5244) – Task Oriented Email Client Example
In this section, I introduced retrieving email in Visual C++ with POP3 protocol.At next section I will introduce how to retrieve email from IMAP4 server.