Change the Filename of an Attachment

See more Email Object Examples

Demonstrates the Chilkat Email.SetAttachmentFilename method, which changes the filename of the attachment at a given zero-based index. This example adds an attachment and renames it, printing the filename before and after.

Background: The attachment filename is what a recipient sees and what most clients suggest when saving the file. Renaming it is handy when the original name is unclear, unsafe, or generic — for example giving a machine-generated tmp12345 a meaningful name like invoice.pdf before sending.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkEmail email;

    success = FALSE;

    //  Demonstrates the SetAttachmentFilename method, which changes the filename of the
    //  attachment at the given zero-based index.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Set attachment filename");

    CkEmail_AddStringAttachment(email,"oldname.txt","Some notes.");
    printf("Filename before: %s\n",CkEmail_getAttachmentFilename(email,0));

    //  Change the filename of the first attachment (index 0).
    success = CkEmail_SetAttachmentFilename(email,0,"newname.txt");
    if (success == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkEmail_Dispose(email);
        return;
    }

    printf("Filename after: %s\n",CkEmail_getAttachmentFilename(email,0));


    CkEmail_Dispose(email);

    }