(C) 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++ 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_CkBounce.h>
#include <C_CkMailMan.h>
#include <C_CkEmailBundle.h>
#include <C_CkEmail.h>

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

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

    bounce = CkBounce_Create();

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

    // 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 (CkMailMan_getLastMethodSuccess(mailman) == FALSE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkBounce_Dispose(bounce);
        CkMailMan_Dispose(mailman);
        return;
    }

    i = 0;

    while (i < CkEmailBundle_getMessageCount(bundle)) {
        email = CkEmailBundle_GetEmail(bundle,i);

        success = CkBounce_ExamineEmail(bounce,email);
        if (success == FALSE) {
            printf("%s\n",CkBounce_lastErrorText(bounce));
            CkEmailBundle_Dispose(bundle);
            CkBounce_Dispose(bounce);
            CkMailMan_Dispose(mailman);
            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);

        i = i + 1;
    }

    CkEmailBundle_Dispose(bundle);

    success = CkMailMan_Pop3EndSession(mailman);


    CkBounce_Dispose(bounce);
    CkMailMan_Dispose(mailman);

    }