(MFC) Bounced Email Handling

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

Chilkat C/C++ Library Downloads MS Visual C/C++ Libs

See Also: Using MFC CString in Chilkat

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

void ChilkatSample(void)
    {
    CkString strOut;

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

    CkBounce bounce;

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

    // 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");

    // 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.)
    CkEmailBundle *bundle = mailman.CopyMail();
    if (mailman.get_LastMethodSuccess() == false) {
        strOut.append(mailman.lastErrorText());
        strOut.append("\r\n");
        SetDlgItemText(IDC_EDIT1,strOut.getUnicode());
        return;
    }

    int i = 0;
    CkEmail *email = 0;
    while (i < bundle->get_MessageCount()) {
        email = bundle->GetEmail(i);

        bool success = bounce.ExamineEmail(*email);
        if (success == false) {
            strOut.append(bounce.lastErrorText());
            strOut.append("\r\n");
            delete bundle;
            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;

        i = i + 1;
    }

    delete bundle;

    success = mailman.Pop3EndSession();


    SetDlgItemText(IDC_EDIT1,strOut.getUnicode());

    }