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

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

void ChilkatSample(void)
    {
    HCkBounce bounce;
    BOOL success;
    HCkMailMan mailman;
    HCkEmailBundle bundle;
    long i;
    HCkEmail email;

    bounce = CkBounce_Create();

    success = CkBounce_UnlockComponent(bounce,"Anything for 30-day trial");
    if (success == FALSE) {
        printf("%s\n",CkBounce_lastErrorText(bounce));
        return;
    }

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

    //  Any string argument automatically begins the 30-day trial.
    success = CkMailMan_UnlockComponent(mailman,"30-day trial");
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        return;
    }

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

    //  Set the POP3 login/password.
    CkMailMan_putPopUsername(mailman,"myLogin");
    CkMailMan_putPopPassword(mailman,"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.)
    bundle = CkMailMan_CopyMail(mailman);

    if (bundle == 0 ) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        return;
    }

    for (i = 0; i <= CkEmailBundle_getMessageCount(bundle) - 1; i++) {
        email = CkEmailBundle_GetEmail(bundle,i);

        success = CkBounce_ExamineEmail(bounce,email);
        if (success == FALSE) {
            printf("%s\n",CkBounce_lastErrorText(bounce));
            return;
        }

        if (CkBounce_getBounceType(bounce) == 1) {
            //  Hard bounce, log the email address
            printf("Hard Bounce: %s\n",CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 2) {
            //  Soft bounce, log the email address
            printf("Soft Bounce: %s\n",CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 3) {
            //  General bounce, no email address available.
            printf("General Bounce: No email address\n");
        }

        if (CkBounce_getBounceType(bounce) == 4) {
            //  General bounce, log the email address
            printf("General Bounce: %s\n",CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 5) {
            //  Mail blocked, log the email address
            //  A bounce occured because the sender was blocked.
            printf("Mail Blocked: %s\n",CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 6) {
            //  Auto-reply, log the email address
            printf("Auto-Reply: %s\n",CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 7) {
            //  Transient (recoverable) Failure, log the email address
            printf("Transient Failure: %s\n"
                ,CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 8) {
            //  Subscribe request, log the email address
            printf("Subscribe Request: %s\n"
                ,CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 9) {
            //  Unsubscribe Request, log the email address
            printf("Unsubscribe Request: %s\n"
                ,CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 10) {
            //  Virus Notification, log the email address
            printf("Virus Notification: %s\n"
                ,CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 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.
            printf("Suspected Bounce!\n");
        }

        if (CkBounce_getBounceType(bounce) == 12) {
            //  Challenge/Response - Auto-reply message sent by SPAM software
            //  where only verified email addresses are accepted.
            printf("Challenge: %s\n",CkBounce_bounceAddress(bounce));
        }

        if (CkBounce_getBounceType(bounce) == 13) {
            //  Address Change Notification Message.
            printf("Address Change: %s\n",CkBounce_bounceAddress(bounce));
        }

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

        CkEmail_Dispose(email);
    }

    CkEmailBundle_Dispose(bundle);

    CkMailMan_Pop3EndSession(mailman);

    CkBounce_Dispose(bounce);
    CkMailMan_Dispose(mailman);

    }