C++

Example to Add Several BCC Email Recipients

See more Email Object Examples

Demonstrates how to call AddBCC once per email recipient. C++

#include <CkEmail.h>
#include <CkMailMan.h>

void ChilkatSample(void)
    {
    bool success = false;

    CkEmail email;

    email.put_Subject("Test email subject");
    email.put_Body("Test email body");

    email.put_From("Test <joe@example.com>");

    //  Add a primary TO recipient
    email.AddTo("Elizabeth","elizabeth@example.com");

    //  Add a CC recipient.
    email.AddCC("Jerry","jerry@example.com");

    //  Add 2 BCC recipients.
    email.AddBcc("Mira","mira@example.com");
    email.AddBcc("Alexander","alex@example.com");

    //  BCC recipients will not be present in the MIME of the email that is sent.
    //  However, the BCC recipients are included in the recipients provided to the SMTP server
    //  during the SMTP protocol conversation. This will be shown below.

    //  First, let's look at the MIME.
    std::cout << email.getMime() << "\r\n";

    //  MIME-Version: 1.0
    //  Date: Sat, 30 Oct 2021 07:58:32 -0500
    //  Message-ID: <183D5F51163BE4374B494D2ED067DE2783CC761B@SLICE>
    //  Content-Type: text/plain; charset=us-ascii; format=flowed
    //  Content-Transfer-Encoding: 7bit
    //  X-Priority: 3 (Normal)
    //  Subject: Test email subject
    //  From: Test <joe@example.com>
    //  To: Elizabeth <elizabeth@example.com>
    //  Cc: Jerry <jerry@example.com>
    //  
    //  Test email body

    //  Notice that the BCC recipients do not appear in the MIME.  But don't worry, they are still present within the email object.
    //  The difference between CC and BCC recipients is that CC recipients appear in the MIME.  Thus, the recipient of the email
    //  can see the CC recipients, but cannot see and is unaware of the BCC recipients.

    //  ----------------------------------------------------------------------------------------------
    //  Let's send the above email and examine the SMTP session log to show that the BCC recipients also receive the email.

    CkMailMan mailman;

    mailman.put_SmtpHost("smtp.example.com");
    mailman.put_SmtpUsername("myUsername");
    mailman.put_SmtpPassword("myPassword");
    mailman.put_SmtpSsl(true);
    mailman.put_SmtpPort(465);

    success = mailman.SendEmail(email);
    if (success != true) {
        std::cout << mailman.lastErrorText() << "\r\n";
        return;
    }

    success = mailman.CloseSmtpConnection();
    if (success != true) {
        std::cout << "Connection to SMTP server not closed cleanly." << "\r\n";
    }

    std::cout << "Mail Sent!" << "\r\n";

    //  Examine the SMTP session log.
    std::cout << mailman.smtpSessionLog() << "\r\n";

    //  Here you can see the session log and the BCC email addresses included in the "RCPT TO" commands.

    //  220 smtp.example.com ESMTP Example SMTP Service
    //  EHLO SLICE<CRLF>
    //  250-smtp.example.com
    //  250-8BITMIME
    //  250-AUTH PLAIN LOGIN
    //  250 Ok
    //  AUTH LOGIN<CRLF>
    //  334 VXNlcm5hbWU6
    //  ***<CRLF>
    //  334 UGFzc3dvcmQ6
    //  {PasswordOrCredentials}
    //  235 Authentication successful.
    //  MAIL FROM:<joe@example.com><CRLF>
    //  250 Ok
    //  RCPT TO:<elizabeth@example.com><CRLF>
    //  250 Ok
    //  RCPT TO:<jerry@example.com><CRLF>
    //  250 Ok
    //  RCPT TO:<mira@example.com><CRLF>
    //  250 Ok
    //  RCPT TO:<alex@example.com><CRLF>
    //  250 Ok
    //  DATA<CRLF>
    //  354 End data with <CR><LF>.<CR><LF>
    //  {388 bytes}
    //  <CRLF>.<CRLF>
    //  250 Ok
    //  QUIT<CRLF>
    //  221 Bye
    }