Bounced Email Handling

Demonstrates how to examine emails and detect which are bounced (automated) replies. Classifies each email according to the type of bounce.

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

// Needs #include <CkBounce.h>
// Needs #include <CkMailMan.h>
// Needs #include <CkEmailBundle.h>
// Needs #include <CkEmail.h>

    CkString strOut;

    CkBounce bounce;

    bool success;
    success = bounce.UnlockComponent("Anything for 30-day trial");
    if (success == false) {
        strOut.append(bounce.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    //  The mailman object is used for receiving (POP3)
    //  and sending (SMTP) email.
    CkMailMan mailman;

    //  Any string argument automatically begins the 30-day trial.
    success = mailman.UnlockComponent("30-day trial");
    if (success != true) {
        strOut.append(mailman.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    //  Set the POP3 server's hostname
    mailman.put_MailHost("mail.chilkatsoft.com");

    //  Set the POP3 login/password.
    mailman.put_PopUsername("myLogin");
    mailman.put_PopPassword("myPassword");

    CkEmailBundle *bundle = 0;
    //  Copy the all email from the user's POP3 mailbox
    //  into a bundle object.  The email remains on the server.
    //  (There are other methods for deleting email from a POP3 server.)
    bundle = mailman.CopyMail();

    if (bundle == 0 ) {
        strOut.append(mailman.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    long i;
    CkEmail *email = 0;
    for (i = 0; i <= bundle->get_MessageCount() - 1; i++) {
        email = bundle->GetEmail(i);

        success = bounce.ExamineEmail(*email);
        if (success == false) {
            strOut.append(bounce.lastErrorText());
            strOut.append("\r\n");
            SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
            return;
        }

        if (bounce.get_BounceType() == 1) {
            //  Hard bounce, log the email address
            strOut.append("Hard Bounce: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 2) {
            //  Soft bounce, log the email address
            strOut.append("Soft Bounce: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 3) {
            //  General bounce, no email address available.
            strOut.append("General Bounce: No email address");
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 4) {
            //  General bounce, log the email address
            strOut.append("General Bounce: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 5) {
            //  Mail blocked, log the email address
            //  A bounce occured because the sender was blocked.
            strOut.append("Mail Blocked: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 6) {
            //  Auto-reply, log the email address
            strOut.append("Auto-Reply: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 7) {
            //  Transient (recoverable) Failure, log the email address
            strOut.append("Transient Failure: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 8) {
            //  Subscribe request, log the email address
            strOut.append("Subscribe Request: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 9) {
            //  Unsubscribe Request, log the email address
            strOut.append("Unsubscribe Request: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 10) {
            //  Virus Notification, log the email address
            strOut.append("Virus Notification: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 11) {
            //  Suspected bounce.
            //  This should be rare.  It indicates that the Bounce
            //  component found strong evidence that this is a bounced
            //  email, but couldn't quite recognize everything it
            //  needed to be 100% sure.  Feel free to notify
            //  support@chilkatsoft.com regarding emails having this
            //  bounce type.
            strOut.append("Suspected Bounce!");
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 12) {
            //  Challenge/Response - Auto-reply message sent by SPAM software
            //  where only verified email addresses are accepted.
            strOut.append("Challenge: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 13) {
            //  Address Change Notification Message.
            strOut.append("Address Change: ");
            strOut.append(bounce.bounceAddress());
            strOut.append("\r\n");
        }

        if (bounce.get_BounceType() == 14) {
            //  Success DSN indicating that the message was successfully relayed.
            strOut.append("DSN Successful Relay: ");
            strOut.append("\r\n");
        }

        delete email;
    }

    delete bundle;

    mailman.Pop3EndSession();

    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());