Lianja

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 Lianja Downloads

Download Chilkat for Lianja

Lianja

llSuccess = .F.

//  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.
loInnerEmail = createobject("CkEmail")
loInnerEmail.Subject = "Embedded message"
loInnerEmail.From = "alice@example.com"
loInnerEmail.AddTo("Bob","bob@example.com")

//  Attach it to an outer email as a message/rfc822 part.
loEmail = createobject("CkEmail")
loEmail.Subject = "Has an attached message"
llSuccess = loEmail.AttachEmail(loInnerEmail)
if (llSuccess = .F.) then
    ? loEmail.LastErrorText
    release loInnerEmail
    release loEmail
    return
endif

//  Get the filename of the first attached message (index 0).
lcFname = loEmail.GetAttachedMessageFilename(0)
? "Attached message filename: " + lcFname


release loInnerEmail
release loEmail