C

MailMan GetSentToEmailAddrs

Demonstrates how to get the email addresses accepted by the SMTP server during an SMTP send. C

#include <C_CkMailMan.h>
#include <C_CkEmail.h>
#include <C_CkStringArray.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkMailMan mailman;
    HCkEmail email;
    HCkStringArray acceptedAddrs;
    int numAddrs;
    int i;

    success = FALSE;

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

    //  Demonstrates how to get the successful recipients for the last email sent.

    //  Note: Success does not ensure actual delivery, nor does it mean the email address is actually valid.
    //  It may be that the email address is invalid and will get bounced at the destination.

    //  Also: An SMTP client (such as Chilkat, Mozilla Thunderbird, etc.) is only responsible for "handing off" the email to the SMTP server 
    //  for delivery (either to a local mailbox, or to a remote mailbox where the SMTP server acts as a relay). 
    //  The SMTP client's task is ended when the SMTP protocol exchange is completed, and the SMTP server says "OK, I've got it and I'll take it from here.". 
    //  If the email never actually gets delivered, then there is a problem downstream of the Chilkat-->SMTP server handoff.

    mailman = CkMailMan_Create();

    CkMailMan_putSmtpHost(mailman,"outlook.office365.com");
    CkMailMan_putSmtpPort(mailman,587);
    CkMailMan_putStartTLS(mailman,TRUE);

    //  Set the SMTP login/password
    CkMailMan_putSmtpUsername(mailman,"OFFICE365-SMTP-LOGIN");
    CkMailMan_putSmtpPassword(mailman,"OFFICE365-SMTP-PASSWORD");

    //  Create a new email object
    email = CkEmail_Create();

    CkEmail_putSubject(email,"Testing for Chilkat API...");
    CkEmail_putBody(email,"Testing for Chilkat API...");
    CkEmail_putFrom(email,"Chilkat Support <my-office365-user@mydomain.com>");
    success = CkEmail_AddTo(email,"Chilkat Admin","admin@chilkatsoft.com");
    success = CkEmail_AddTo(email,"Chilkat Support","support@chilkatsoft.com");
    //  To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

    //  Allow SendEmail to succeed even if some recipients are rejected immediately
    //  by the SMTP server.
    CkMailMan_putAllOrNone(mailman,FALSE);

    //  Call SendEmail to connect to the SMTP server and send.
    //  The connection (i.e. session) to the SMTP server remains
    //  open so that subsequent SendEmail calls may use the
    //  same connection.  
    success = CkMailMan_SendEmail(mailman,email);
    if (success != TRUE) {
        printf("%s\n",CkMailMan_lastErrorText(mailman));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        return;
    }

    success = CkMailMan_CloseSmtpConnection(mailman);
    if (success != TRUE) {
        printf("Connection to SMTP server not closed cleanly.\n");
    }

    printf("Mail Sent!\n");

    //  Examine which email addresses were accepted by the SMTP server during the SMTP conversation. 
    //  (i.e. during the SendEmail)
    acceptedAddrs = CkMailMan_GetSentToEmailAddrs(mailman);
    numAddrs = CkStringArray_getCount(acceptedAddrs);
    i = 0;
    while (i < numAddrs) {
        printf("Accepted recipient %d: %s\n",i,CkStringArray_getString(acceptedAddrs,i));
        i = i + 1;
    }

    CkStringArray_Dispose(acceptedAddrs);


    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(email);

    }