(C) Rename Email Attachments After Adding

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

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_CkMailMan.h>
#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkMailMan mailman;
    HCkEmail email;
    BOOL success;
    const char *contentType;

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

    mailman = CkMailMan_Create();

    CkMailMan_putSmtpHost(mailman,"smtp.my-mail-server.com");
    CkMailMan_putSmtpUsername(mailman,"MY_SMTP_USERNAME");
    CkMailMan_putSmtpPassword(mailman,"MY_SMTP_PASSWORD");
    CkMailMan_putSmtpSsl(mailman,TRUE);
    CkMailMan_putSmtpPort(mailman,465);

    email = CkEmail_Create();

    CkEmail_putSubject(email,"This is a test");
    CkEmail_putBody(email,"This is a test");
    CkEmail_putFrom(email,"Chilkat Support <support@chilkatsoft.com>");
    success = CkEmail_AddTo(email,"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.
    contentType = CkEmail_addFileAttachment(email,"qa_data/jpg/starfish.jpg");
    if (CkEmail_getLastMethodSuccess(email) != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        return;
    }

    contentType = CkEmail_addFileAttachment(email,"qa_data/pdf/fishing.pdf");
    if (CkEmail_getLastMethodSuccess(email) != TRUE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        return;
    }

    // If we save the email to a .eml, we can examine in a text editor.
    success = CkEmail_SaveEml(email,"qa_output/e1.eml");
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        printf("Failed to save .eml\n");
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        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 = CkEmail_SetAttachmentFilename(email,0,"orange_starfish.jpg");
    success = CkEmail_SetAttachmentFilename(email,1,"tuna_fishing.pdf");

    // Look at the new MIME source of the email in a  text editor...
    success = CkEmail_SaveEml(email,"qa_output/e2.eml");
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        printf("Failed to save .eml\n");
        CkMailMan_Dispose(mailman);
        CkEmail_Dispose(email);
        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 = 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 with attachments sent!\n");


    CkMailMan_Dispose(mailman);
    CkEmail_Dispose(email);

    }