Xbase++

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 Xbase++ Downloads

Download Chilkat for Xbase++

Xbase++

LOCAL nSuccess
LOCAL oInnerEmail
LOCAL oEmail
LOCAL cFname

nSuccess := 0

//  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.
oInnerEmail := CreateObject("Chilkat.Email")
oInnerEmail:Subject := "Embedded message"
oInnerEmail:From := "alice@example.com"
oInnerEmail:AddTo("Bob", "bob@example.com")

//  Attach it to an outer email as a message/rfc822 part.
oEmail := CreateObject("Chilkat.Email")
oEmail:Subject := "Has an attached message"
nSuccess := oEmail:AttachEmail(oInnerEmail)
IF (nSuccess == 0)
    ? oEmail:LastErrorText
    oInnerEmail:destroy()
    oEmail:destroy()
    RETURN
ENDIF

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

oInnerEmail:destroy()
oEmail:destroy()