Xojo Plugin

Get the Filename of an Attached Message

See more Email Object Examples

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 Xojo Plugin Downloads

Download Chilkat for Xojo Plugin

Xojo Plugin

Dim success As Boolean
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.
Dim innerEmail As New Chilkat.Email
innerEmail.Subject = "Embedded message"
innerEmail.From = "alice@example.com"
success = innerEmail.AddTo("Bob","bob@example.com")

//  Attach it to an outer email as a message/rfc822 part.
Dim email As New Chilkat.Email
email.Subject = "Has an attached message"
success = email.AttachEmail(innerEmail)
If (success = False) Then
    System.DebugLog(email.LastErrorText)
    Return
End If

//  Get the filename of the first attached message (index 0).
Dim fname As String
fname = email.GetAttachedMessageFilename(0)
System.DebugLog("Attached message filename: " + fname)