Click here to Skip to main content
15,861,172 members
Articles / Desktop Programming / Win32

SMTP Client

Rate me:
Please Sign up or sign in to vote.
4.82/5 (62 votes)
16 Jul 2010CPOL4 min read 681.9K   22.4K   185   166
The CSmtp class allows to send emails with attachments. It only provides the AUTH LOGIN authentication.

Introduction

The CSmtp class allows to send emails from your program. The inspiration to write the CSmtp class was the article: CFastSmtp - A fast and easy SMTP class... I have used the code of CFastSmtp and introduced the following changes:

  • some bags have been removed (i.e., free memory)
  • logging in with authentication has been applied (AUTH LOGIN)
  • sending attachments has been added
  • error handling has been modified
  • new headlines from MIME specifications (i.e., X-Priority) have been added
  • non-blocking mode has been added
  • exceptions have been used
  • compatibility with Linux systems has been ensured

Typical scenarios while sending emails

After successful connection to an SMTP server, our client starts the conversation with the remote SMTP server. Each line sent by the client ought to be finished by "\r\n". If you want to know more details, check the References: [2], [3], [4], [5], [6], [7], [8], and [9]. In [2] is described the original SMTP protocol (1982), in [4] is discussed the SMTP extensions for authentication, and the MIME specification is improved in [5]-[9]. Below there are shown typical scenarios while sending e-mails. Example 3 fails because no TLS procedures were implemented in the CSmtp class. If you want to add TLS, see OpenSSL. I have introduced the following notation: S is a remote server, C is our client, and xxx means information censured.

Example 1 - Connecting to smtp.wp.pl and using an incorrect login or password:

S: 220 smtp.wp.pl ESMTP
C: EHLO: mydomain.com
S: 250-smtp.wp.pl
   250-PIPELINING
   250-AUTH=LOGIN PLAIN
   250-AUTH LOGIN PLAIN
   250-STARTTLS
   250-SIZE
   250-X-RCPTLIMIT 100
   250-8BITMIME
C: AUTH LOGIN
S: 334 VXNlcm5hbWU6
C: Kioq
S: 334 UGFzc3dvcmQ6
C: Kioq
S: 535 blad autoryzacji, niepoprawny login lub haslo / auth failure

Example 2 - Connecting to smtp.wp.pl and using the correct login and password:

S: 220 smtp.wp.pl ESMTP
C: EHLO: mydomain.com
S: 250-smtp.wp.pl
   250-PIPELINING
   250-AUTH=LOGIN PLAIN
   250-AUTH LOGIN PLAIN
   250-STARTTLS
   250-SIZE
   250-X-RCPTLIMIT 100
   250-8BITMIME
C: AUTH LOGIN
S: 334 VXNlcm5hbWU6
C: xxx
S: 334 UGFzc3dvcmQ6
C: xxx
S: 235 go ahead
C: MAIL FROM:<me@mydomain.com>
S: 250 ok
C: RCPR TO:<friend@domain.com>
S: 250 ok
C: DATA
S: 234 go ahead
C: Date: Sun, 24 Aug 2008 22:43:45
   From: JP<mail@domain.com>
   X-Mailer: The Bat! (v3.02) Professional
   Replay-to:mail@domain.com
   X-Priority: 3 (Normal)
   To:<friend@domain.com>
   Subject: The message
   MIME Version 1.0
   Content-Type: multipart/mixed; boundary="__MESSAGE__ID__54yg6f6h6y456345"

   
   --__MESSAGE__ID__54yg6f6h6y456345
   Content-type: text/plain; charset=US-ASCII
   Content-Transfer-Encoding: 7bit

   This is my message.

   --__MESSAGE__ID__54yg6f6h6y456345
   Content-Type: application/x-msdownload; name="test.exe"
   Content-Transfer-Encoding: base64
   Content-Disposition: attachment; filename="test.exe"
   
   TVqQAAMAAAAEAAAA//8AALgAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
   (...)
   SU5HWFhQQURESU5HUEFERElOR1hYUEFERElOR1BBRERJTkdYWFBBRERJTkdQQURESU5HWA==
   --__MESSAGE__ID__54yg6f6h6y456345
   Content-Type: application/x-msdownload; name="test2.jpg"
   Content-Transfer-Encoding: base64
   Content-Disposition: attachment; filename="test2.jpg"
   
   /9j/4Sv+RXhpZgAASUkqAAgAAAAJAA8BAgAGAAAAegAAABABAgAWAAAAgAAAABIBAwABAAAA
   (...)
   A6YxR5YJJ5zUu6ZW4+NjC24E4q5Dcox5I+lRI0iWAAV9aay+lTctoYTjrml+9irRmz//2Q==
   
   --__MESSAGE__ID__54yg6f6h6y456345--
   
   .
   
S: 250 ok xxx qp xxx
C: QUIT
S: 221 smtp.wp.pl

Example 3 - Connecting to smtp.gmail.com:

S: 220 mx.google.com ESMTP
   w28sm1561195uge.4
C: EHLO: mydomain.com
S: 250-mx.google.com at your service [xxx.xxx.xxx.xxx],
   250-SIZE 28311552
   250-8BITMIME
   250-STARTTLS
   250 ENHANCEDSTATUSCODES
C: AUTH LOGIN
S: 530 5.7.0 Must issue a STARTTLS command first. w28sm1561195uge.4

Example 4 - Connecting to smtp.bizmail.yahoo.com and using an incorrect login or password:

S: 220 smtp103.biz.mail.re2.yahoo.com ESMTP
C: EHLO: mydomain.com
S: 250-smtp103.biz.mail.re2.yahoo.com
   250-AUTH LOGIN PLAIN XYMCOOKIE
   250-PIPELINING
   250-8BITMIME
C: AUTH LOGIN
S: 334 VXNlcm5hbWU6
C: dG9t
S: 334 UGFzc3dvcmQ6
C: bmVyb24xMg==
S: 535 authorization failed (#5.7.0)

Implementation of the CSmtp class

Implementation of the CSmtp class is very similar for Windows and Linux OSs. There is nothing surprising in this, because Windows uses the generally accepted Berkeley sockets application programming interface (API) [10]. The differences are shown in Table 1 (applies only to the CSmtp class implementation).

Table 1. Differences in implementation.
WindowsLinux
Winsock initialization neededNo Winsock initialization
Uses function closesocketUses function close
Uses function ioctlsocketUses function ioctl
Defined helpful type aliases; i.e., SOCKET, SOCKADDR_IN, LPHOSTENT, LPSERVENT, LPIN_ADDR, LPSOCKADDRAdditional types aliase should be defined

Below there are shown steps to be taken when connecting to a remote SMTP server.

  1. In Windows only, initialize Winsock2 (function: WSAStartup).
  2. Get socket descriptor on the local machine (function: socket).
  3. Convert port value (i.e., 25) to TCP/IP byte order (function: htons).
  4. Obtain Internet address of the remote machine (functions: inet_addr, gethostbyname).
  5. If non-blocking mode is used, set socket parameters (function: ioctl/ioctlsocket). Check necessarily what returns each function which will be called after ioctl/ioctlsocket (see next section - Using non-blocking mode).
  6. Connect to the remote server (function: connect).
  7. Introduce yourself - EHLO <SP> <domain> <CRLF>.
  8. Send AUTH LOGIN <CRLF> and another command described in the section "Typical scenarios while sending the email" (functions: send, recv).
  9. Finish the conversation with QUIT <CRLF>.
  10. Close connection with remote machine (function: close/closesocket).
  11. In Windows only, free Winsock2 resources (function: WSACleanup).

Using non-blocking mode

In the latest version of the program, I have used a non-blocking connection. There are many strategies to implement the non-blocking mode (i.e., Select model, WSAAsyncSelect model, WSAEventSelect model, or Completion port I/O model). In my code, I have decided to use the Select model. It is not so complicated as other methods, and works efficiently with a basic connection - one client to one server. The advantages of using non-blocking mode are: the program does not suspend if the remote server stops responding, data can be sent in uneven and unequal portions. Disadvantage of this approach is its complexity. After placing the socket in non-blocking mode, the next API calls are immediately closed. Typically, these calls fail with a an error WSAEWOULDBLOCK (Windows) or EINPROGRESS (Linux), which means that the requested operation is not completed so far. Therefore, in non-blocking mode, a lot of attention should be devoted to analyze errors returned by the API functions. In Select model, we are using the select function [11] after calling such API functions as: send, recv, connect, accept, and others. The parameter ndfs in select is ignored in Windows, but in Linux, it is the highest-numbered file descriptor in any of the three sets (fd_set *readfds, fd_set *writefds, fd_set *exceptfds) plus 1. To illustrate the difference between blocking and non-blocking modes, presented here are two ways of connecting to the remote server. For greater legibility, I have only presented versions for Windows (preprocessor directives were omitted).

C++
/*Connecting to the remote server in blocking mode*/
SOCKET CSmtp::ConnectRemoteServer(const char *szServer,const unsigned short nPort_)
{
    unsigned short nPort = 0;
    LPSERVENT lpServEnt;
    SOCKADDR_IN sockAddr;
    unsigned long ul = 1;
    int res = 0;

    SOCKET hSocket = INVALID_SOCKET;

    if((hSocket = socket(PF_INET, SOCK_STREAM,0)) == INVALID_SOCKET)
        throw ECSmtp(ECSmtp::WSA_INVALID_SOCKET);

    if(nPort_ != 0)
        nPort = htons(nPort_);
    else
    {
        lpServEnt = getservbyname("mail", 0);
        if (lpServEnt == NULL)
            nPort = htons(25);
        else 
            nPort = lpServEnt->s_port;
    }

    sockAddr.sin_family = AF_INET;
    sockAddr.sin_port = nPort;
    if((sockAddr.sin_addr.s_addr = inet_addr(szServer)) == INADDR_NONE)
    {
        LPHOSTENT host;

        host = gethostbyname(szServer);
        if (host)
            memcpy(&sockAddr.sin_addr,host->h_addr_list[0],host->h_length);
        else
        {
            closesocket(hSocket);
            throw ECSmtp(ECSmtp::WSA_GETHOSTBY_NAME_ADDR);
        }
    }

    if(connect(hSocket,(LPSOCKADDR)&sockAddr,sizeof(sockAddr)) == SOCKET_ERROR)
    {
        closesocket(hSocket);
        throw ECSmtp(ECSmtp::WSA_CONNECT);
    }

    return hSocket;
}

/*Connecting to the remote server in non-blocking mode*/
SOCKET CSmtp::ConnectRemoteServer(const char *szServer,const unsigned short nPort_)
{
    unsigned short nPort = 0;
    LPSERVENT lpServEnt;
    SOCKADDR_IN sockAddr;
    unsigned long ul = 1;
    fd_set fdwrite,fdexcept;
    timeval timeout;
    int res = 0;

    timeout.tv_sec = TIME_IN_SEC;
    timeout.tv_usec = 0;

    SOCKET hSocket = INVALID_SOCKET;

    if((hSocket = socket(PF_INET, SOCK_STREAM,0)) == INVALID_SOCKET)
        throw ECSmtp(ECSmtp::WSA_INVALID_SOCKET);

    if(nPort_ != 0)
        nPort = htons(nPort_);
    else
    {
        lpServEnt = getservbyname("mail", 0);
        if (lpServEnt == NULL)
            nPort = htons(25);
        else 
            nPort = lpServEnt->s_port;
    }

    sockAddr.sin_family = AF_INET;
    sockAddr.sin_port = nPort;
    if((sockAddr.sin_addr.s_addr = inet_addr(szServer)) == INADDR_NONE)
    {
        LPHOSTENT host;

        host = gethostbyname(szServer);
        if (host)
            memcpy(&sockAddr.sin_addr,host->h_addr_list[0],host->h_length);
        else
        {
            closesocket(hSocket);
            throw ECSmtp(ECSmtp::WSA_GETHOSTBY_NAME_ADDR);
        }
    }

    // start non-blocking mode for socket:
    if(ioctlsocket(hSocket,FIONBIO, (unsigned long*)&ul) == SOCKET_ERROR)
    {
        closesocket(hSocket);
        throw ECSmtp(ECSmtp::WSA_IOCTLSOCKET);
    }

    if(connect(hSocket,(LPSOCKADDR)&sockAddr,sizeof(sockAddr)) == SOCKET_ERROR)
    {
        if(WSAGetLastError() != WSAEWOULDBLOCK)
        {
            closesocket(hSocket);
            throw ECSmtp(ECSmtp::WSA_CONNECT);
        }
    }
    else
        return hSocket;

    while(true)
    {
        FD_ZERO(&fdwrite);
        FD_ZERO(&fdexcept);

        FD_SET(hSocket,&fdwrite);
        FD_SET(hSocket,&fdexcept);

        if((res = select(hSocket+1,NULL,&fdwrite,&fdexcept,&timeout)) == SOCKET_ERROR)
        {
            closesocket(hSocket);
            throw ECSmtp(ECSmtp::WSA_SELECT);
        }

        if(!res)
        {
            closesocket(hSocket);
            throw ECSmtp(ECSmtp::SELECT_TIMEOUT);
        }
        
        if(res && FD_ISSET(hSocket,&fdwrite))
            break;

        if(res && FD_ISSET(hSocket,&fdexcept))
        {
            closesocket(hSocket);
            throw ECSmtp(ECSmtp::WSA_SELECT);
        }
    } // while

    FD_CLR(hSocket,&fdwrite);
    FD_CLR(hSocket,&fdexcept);

    return hSocket;
}

Usage

C++
#include "CSmtp.h"
#include <iostream>

int main()
{
    bool bError = false;

    try
    {
        CSmtp mail;

        mail.SetSMTPServer("smtp.domain.com",25);
        mail.SetLogin("***");
        mail.SetPassword("***");
        mail.SetSenderName("User");
        mail.SetSenderMail("user@domain.com");
        mail.SetReplyTo("user@domain.com");
        mail.SetSubject("The message");
        mail.AddRecipient("friend@domain2.com");
        mail.SetXPriority(XPRIORITY_NORMAL);
        mail.SetXMailer("The Bat! (v3.02) Professional");
        mail.AddMsgLine("Hello,");
        mail.AddMsgLine("");
        mail.AddMsgLine("How are you today?");
        mail.AddMsgLine("");
        mail.AddMsgLine("Regards");
        mail.AddMsgLine("--");
        mail.AddMsgLine("User");
        mail.AddAttachment("c:\\test.exe");
        mail.AddAttachment("c:\\test2.jpg");
    
        mail.Send();
    }
    catch(ECSmtp e)
    {
        std::cout << "Error: " << e.GetErrorText().c_str() << ".\n";
        bError = true;
    }

    if(!bError)
    {
        std::cout << "Mail was send successfully.\n";
        return 0;
    }
    else
        return 1;
}

Author's notes

  1. If you have problems sending an email, use Visual Studio's debugger and analyze the conversation between your SMTP server and the client; perhaps, your server needs a different kind of authentication or doesn't need it at all.
  2. You are not allowed to use the CSmtp class for spamming.

Bibliography

  1. CFastSmtp - Fast and easy SMTP class...
  2. Simple Mail Transfer Protocol RFC 821
  3. Standard for the Format of ARPA Internet Text Messages RFC 822
  4. SMTP Service Extension for Authentication RFC 2554
  5. MIME: Format of Internet Message Bodies RFC 2045
  6. MIME: Media Types RFC 2046
  7. MIME: Message Header Extensions for Non-ASCII Text RFC 2047
  8. MIME: Registration Procedures RFC 2048
  9. MIME: Conformance Criteria and Examples RFC 2049
  10. The Berkeley Sockets Application Programming Interface (API)
  11. select function

License

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


Written By
Engineer Technical University of Lodz
Poland Poland
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralMy vote of 5 Pin
jacksp19-Nov-10 20:13
jacksp19-Nov-10 20:13 
QuestionRename Attachement. Pin
kirubalks8-Nov-10 16:43
kirubalks8-Nov-10 16:43 
AnswerRe: Rename Attachement. Pin
min_2_max17-May-11 18:02
min_2_max17-May-11 18:02 
GeneralVirus Alert. Pin
kirubalks18-Oct-10 2:29
kirubalks18-Oct-10 2:29 
GeneralRe: Virus Alert. Pin
Jakub Piwowarczyk24-Oct-10 0:15
Jakub Piwowarczyk24-Oct-10 0:15 
GeneralMy vote of 5 Pin
kirubalks18-Oct-10 2:13
kirubalks18-Oct-10 2:13 
AnswerPossible Solution To Misc EHLO Errors Pin
Leon Hauck23-Aug-10 11:12
Leon Hauck23-Aug-10 11:12 
GeneralRe: Possible Solution To Misc EHLO Errors Pin
Jakub Piwowarczyk3-Sep-10 3:08
Jakub Piwowarczyk3-Sep-10 3:08 
Hi,
To fix it you could do:
1. Change function GetLocalHostName
const char* CSmtp::GetLocalHostName() const
{
	return m_sLocalHostName.c_str();
}


2. Change CSmtp constructor

CSmtp::CSmtp()
{
	m_iXPriority = XPRIORITY_NORMAL;
	m_iSMTPSrvPort = 0;

#ifndef LINUX
	// Initialize WinSock
	WSADATA wsaData;
	WORD wVer = MAKEWORD(2,2);    
	if (WSAStartup(wVer,&wsaData) != NO_ERROR)
		throw ECSmtp(ECSmtp::WSA_STARTUP);
	if (LOBYTE( wsaData.wVersion ) != 2 || HIBYTE( wsaData.wVersion ) != 2 ) 
	{
		WSACleanup();
		throw ECSmtp(ECSmtp::WSA_VER);
	}
#endif

	char* str = NULL;
	if((str = new char[255]) == NULL)
		throw ECSmtp(ECSmtp::LACK_OF_MEMORY);
	if(gethostname(str,255) == SOCKET_ERROR)
	{
		delete[] str;
		throw ECSmtp(ECSmtp::WSA_HOSTNAME);
	}
	m_sLocalHostName.insert(0,str);
	delete[] str;
	
	if((RecvBuf = new char[BUFFER_SIZE]) == NULL)
		throw ECSmtp(ECSmtp::LACK_OF_MEMORY);
	
	if((SendBuf = new char[BUFFER_SIZE]) == NULL)
		throw ECSmtp(ECSmtp::LACK_OF_MEMORY);
}


3. Change one line in Send fiunction

// EHLO <SP> <domain> <CRLF>
sprintf(SendBuf,"EHLO %s\r\n",GetLocalHostName());
SendData();
bAccepted = false;


Let me know if it didn't help.
Jakub Piwowarczyk

GeneralRe: Possible Solution To Misc EHLO Errors Pin
min_2_max17-May-11 18:10
min_2_max17-May-11 18:10 
GeneralRe: Possible Solution To Misc EHLO Errors Pin
highersky16-Aug-12 21:54
highersky16-Aug-12 21:54 
GeneralRe: Possible Solution To Misc EHLO Errors Pin
曹杰30-Dec-13 2:50
曹杰30-Dec-13 2:50 
Generaldont work on gmail.com Pin
nill777nill19-Aug-10 5:01
nill777nill19-Aug-10 5:01 
GeneralRe: dont work on gmail.com Pin
Jakub Piwowarczyk3-Sep-10 3:12
Jakub Piwowarczyk3-Sep-10 3:12 
GeneralSSL/TLS added to SMTP client Pin
John_Tang3-Aug-10 10:06
John_Tang3-Aug-10 10:06 
GeneralSize of body mail Pin
josthubert3-Aug-10 4:50
josthubert3-Aug-10 4:50 
GeneralRe: Size of body mail Pin
Jakub Piwowarczyk3-Sep-10 3:32
Jakub Piwowarczyk3-Sep-10 3:32 
Generalsmall csmtp bug Pin
MrMoje30-Jul-10 0:53
MrMoje30-Jul-10 0:53 
GeneralRe: small csmtp bug Pin
Jakub Piwowarczyk30-Jul-10 2:22
Jakub Piwowarczyk30-Jul-10 2:22 
GeneralAttached file Pin
josthubert27-Jul-10 9:16
josthubert27-Jul-10 9:16 
GeneralRe: Attached file Pin
Jakub Piwowarczyk29-Jul-10 2:25
Jakub Piwowarczyk29-Jul-10 2:25 
GeneralMy vote of 5 Pin
Member 432084420-Jul-10 22:35
Member 432084420-Jul-10 22:35 
GeneralMultiple Recipients issue [modified] Pin
cornoil30-Jun-10 6:49
cornoil30-Jun-10 6:49 
GeneralRe: Multiple Recipients issue Pin
Jakub Piwowarczyk30-Jun-10 10:44
Jakub Piwowarczyk30-Jun-10 10:44 
Generalthank you Pin
wj1234517-May-10 22:25
wj1234517-May-10 22:25 
GeneralVery good code, but: Pin
p3rsianbabyboy14-Apr-10 15:32
p3rsianbabyboy14-Apr-10 15:32 

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.