(C) Send a Simple Email

Create a simple email and sends it. The SendEmail method establishes a connection (session) with the SMTP server if necessary, and leaves the connection open so that additional sends may proceed using the same session. The SMTP connection (session) may be explicitly closed by calling CloseSmtpSession.

Important: Some SMTP servers do not actually send the email until the connection is closed. In these cases, it is necessary to call CloseSmtpConnection for the mail to be sent. Most SMTP servers send the email immediately, and it is not required to close the connection.

More information about minimizing SMTP connections.

Chilkat C/C++ Library Downloads
MS Visual C/C++ Linux/CentOS C/C++ Alpine Linux C/C++ MAC OS X C/C++	armhf/aarch64 C/C++ C++ Builder iOS C/C++ Android C/C++	Solaris C/C++ MinGW C/C++

#include <C_CkMailMan.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkMailMan mailman;
    HCkEmail email;
    BOOL success;

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    // The mailman object is used for sending and receiving email.
    mailman = CkMailMan_Create();

    // Set the SMTP server.
    CkMailMan_putSmtpHost(mailman,"smtp.my_mail_server.com");

    // Set the SMTP login/password (if required)
    CkMailMan_putSmtpUsername(mailman,"myUsername");
    CkMailMan_putSmtpPassword(mailman,"myPassword");

    // The typical SMTP ports are 465 for implicit SSL/TLS or 587 for explicit SSL/TLS
    CkMailMan_putSmtpPort(mailman,465);
    // For implicit TLS, set SmtpSsl = TRUE
    CkMailMan_putSmtpSsl(mailman,TRUE);
    // For explicit TLS, set StartTLS = TRUE
    CkMailMan_putStartTLS(mailman,TRUE);

    // Create a new email object
    email = CkEmail_Create();

    CkEmail_putSubject(email,"This is a test");
    CkEmail_putBody(email,"This is a test");
    // Don't forget to change this to use your email addresses..
    CkEmail_putFrom(email,"Chilkat Support <support@chilkatsoft.com>");
    success = CkEmail_AddTo(email,"Chilkat Admin","admin@chilkatsoft.com");
    // To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

    // Call SendEmail to connect to the SMTP server and send.
    // The connection (i.e. session) to the SMTP server remains
    // open so that subsequent SendEmail calls may use the
    // same connection.  
    success = CkMailMan_SendEmail(mailman,email);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        return;
    }

    // Some SMTP servers do not actually send the email until 
    // the connection is closed.  In these cases, it is necessary to
    // call CloseSmtpConnection for the mail to be  sent.  
    // Most SMTP servers send the email immediately, and it is 
    // not required to close the connection.  We'll close it here
    // for the example:
    success = CkMailMan_CloseSmtpConnection(mailman);
    if (success != TRUE) {
        printf("Connection to SMTP server not closed cleanly.\n");
    }

    printf("Mail Sent!\n");


    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(email);

    }