Get the Filename of an Attachment

See more Email Object Examples

Demonstrates the Chilkat Email.GetAttachmentFilename method, which retrieves an attachment's filename as stored in the MIME. The index is zero-based. This example adds an attachment and reads its filename.

Background: An attachment's filename comes from the sender's message and is not guaranteed to be safe or unique — it may include path separators or characters that are awkward on the local filesystem, and two attachments can share a name. When saving attachments to disk, treat this value as untrusted input: sanitize it and guard against collisions (see the OverwriteExisting property, which can auto-generate unique names).

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

void ChilkatSample(void)
    {
    HCkEmail email;
    const char *fname;

    //  Demonstrates the GetAttachmentFilename method, which retrieves an attachment's filename
    //  (as stored in the MIME).  The index is zero-based.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Attachment filename");

    CkEmail_AddStringAttachment(email,"notes.txt","Some notes.");

    //  Get the filename of the first attachment (index 0).
    fname = CkEmail_getAttachmentFilename(email,0);
    printf("Attachment 0 filename: %s\n",fname);


    CkEmail_Dispose(email);

    }