C++

Rename Email Attachments After Adding

Demonstrates how to rename email attachments after adding but before sending. C++

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

void ChilkatSample(void)
    {
    bool success = false;

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

    CkMailMan mailman;

    mailman.put_SmtpHost("smtp.my-mail-server.com");
    mailman.put_SmtpUsername("MY_SMTP_USERNAME");
    mailman.put_SmtpPassword("MY_SMTP_PASSWORD");
    mailman.put_SmtpSsl(true);
    mailman.put_SmtpPort(465);

    CkEmail email;

    email.put_Subject("This is a test");
    email.put_Body("This is a test");
    email.put_From("Chilkat Support <support@chilkatsoft.com>");
    success = email.AddTo("Chilkat Admin","admin@chilkatsoft.com");
    //  To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

    //  Add some attachments.
    //  The AddFileAttachment method returns the value of the content-type it chose for the attachment.
    const char *contentType = email.addFileAttachment("qa_data/jpg/starfish.jpg");
    if (email.get_LastMethodSuccess() != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

    contentType = email.addFileAttachment("qa_data/pdf/fishing.pdf");
    if (email.get_LastMethodSuccess() != true) {
        std::cout << email.lastErrorText() << "\r\n";
        return;
    }

    //  If we save the email to a .eml, we can examine in a text editor.
    success = email.SaveEml("qa_output/e1.eml");
    if (success == false) {
        std::cout << email.lastErrorText() << "\r\n";
        std::cout << "Failed to save .eml" << "\r\n";
        return;
    }

    //  We see the following in the e1.eml
    //  Notice that Chilkat replaced the full path with just the filename.
    //  The full local path is not part of the email that gets sent..

    //  ...
    //  --------------020807050607070004010609
    //  Content-Type: image/jpeg; name="starfish.jpg"
    //  Content-Transfer-Encoding: base64
    //  Content-Disposition: attachment; filename="starfish.jpg"
    //  
    //  ...
    //  --------------020807050607070004010609
    //  Content-Type: application/pdf; name="fishing.pdf"
    //  Content-Transfer-Encoding: base64
    //  Content-Disposition: attachment; filename="fishing.pdf"
    //  ...

    //  Before sending, each filename can be changed within the email object.
    //  For example:
    success = email.SetAttachmentFilename(0,"orange_starfish.jpg");
    success = email.SetAttachmentFilename(1,"tuna_fishing.pdf");

    //  Look at the new MIME source of the email in a  text editor...
    success = email.SaveEml("qa_output/e2.eml");
    if (success == false) {
        std::cout << email.lastErrorText() << "\r\n";
        std::cout << "Failed to save .eml" << "\r\n";
        return;
    }

    //  You'll see this:

    //  ...
    //  --------------020807050607070004010609
    //  Content-Type: image/jpeg; name="orange_starfish.jpg"
    //  Content-Transfer-Encoding: base64
    //  Content-Disposition: attachment; filename="orange_starfish.jpg"
    //  
    //  ...
    //  --------------020807050607070004010609
    //  Content-Type: application/pdf; name="tuna_fishing.pdf"
    //  Content-Transfer-Encoding: base64
    //  Content-Disposition: attachment; filename="tuna_fishing.pdf"
    //  ...

    //  Send the email with the updated filenames..
    success = mailman.SendEmail(email);
    if (success != true) {
        std::cout << mailman.lastErrorText() << "\r\n";
        return;
    }

    success = mailman.CloseSmtpConnection();
    if (success != true) {
        std::cout << "Connection to SMTP server not closed cleanly." << "\r\n";
    }

    std::cout << "Mail with attachments sent!" << "\r\n";
    }