Attach a File to an Email

See more Email Object Examples

Demonstrates the Chilkat Email.AddFileAttachment method, which attaches a file read from the filesystem. It returns the content type Chilkat assigned to the attachment (inferred from the file extension). This example attaches a PDF and prints its detected content type.

Background: Each attachment carries a Content-Type (MIME type) such as application/pdf or image/png that tells the receiving client how to handle it. Chilkat gets this from the file's extension. Because attachment bytes are binary, they are Base64-encoded for transport, which is handled automatically — you simply point AddFileAttachment at a path and the file is read, encoded, and packaged into the message.

Chilkat C Downloads

Download Chilkat for C

#include <C_CkEmail.h>

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

    //  Demonstrates the AddFileAttachment method, which attaches a file read from the
    //  filesystem.  It returns the content type Chilkat assigned to the attachment (based on
    //  the file extension), or returns failure if the file could not be read.

    email = CkEmail_Create();
    CkEmail_putSubject(email,"Email with a file attachment");
    CkEmail_putBody(email,"Please see the attached file.");

    //  Attach a file.  The return value is the auto-detected content type.
    contentType = CkEmail_addFileAttachment(email,"qa_data/attachments/report.pdf");
    if (CkEmail_getLastMethodSuccess(email) == FALSE) {
        printf("%s\n",CkEmail_lastErrorText(email));
        CkEmail_Dispose(email);
        return;
    }

    printf("Attached content type = %s\n",contentType);
    printf("NumAttachments = %d\n",CkEmail_getNumAttachments(email));

    //  Note: The path "qa_data/attachments/report.pdf" is a relative local filesystem path,
    //  relative to the current working directory of the running application.


    CkEmail_Dispose(email);

    }