C++

Get the Filename of an Attached Message

Demonstrates the Chilkat Email.GetAttachedMessageFilename method, which returns the filename of the Nth attached (embedded) email. The filename is the filename attribute of the attached message's Content-Disposition header, and the index is zero-based. This example attaches an email and reads the attached message's filename.

Background: When an email forwards another message as an attachment, the nested message is a message/rfc822 part — a complete email tucked inside the carrier. Mail clients often give that part a filename (like forwarded.eml) via its Content-Disposition header so it can be saved to disk. This method reads that filename directly. Attached messages are counted separately from ordinary attachments (see NumAttachedMessages).

Chilkat C++ Downloads

Download Chilkat for C++

C++

#include <CkEmail.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Demonstrates the GetAttachedMessageFilename method, which returns the filename of the
    //  Nth attached (embedded) email.  The filename is the "filename" attribute of the
    //  attached message's Content-Disposition header.  The index is zero-based.

    //  Build an inner email to attach.
    CkEmail innerEmail;
    innerEmail.put_Subject("Embedded message");
    innerEmail.put_From("alice@example.com");
    innerEmail.AddTo("Bob","bob@example.com");

    //  Attach it to an outer email as a message/rfc822 part.
    CkEmail email;
    email.put_Subject("Has an attached message");
    success = email.AttachEmail(innerEmail);
    if (success == false) {
        std::cout << email.lastErrorText() << "\r\n";
        return true;
    }

    //  Get the filename of the first attached message (index 0).
    const char *fname = email.getAttachedMessageFilename(0);
    std::cout << "Attached message filename: " << fname << "\r\n";
    }