:AttachFileEx()


Class

     aprMIME()

 

Syntax

     :AttachFileEx( cFilename, [nOptions], [hMessage] ) -> lSuccess

 

Parameters

 

 

cFilename

Name of file to attach to the current message.

 

nOptions

Optional. Encoding method. Default is MIME_ATTACH_DEFAULT (see table below)

 

hMessage

Optional. Handle of the message to act on. Provided during :CreateMessage() operation

 

Return

Logical indicating Success.

Returns .T. if the operation succeeds, otherwise returns .F.

 

Description

The :AttachFileEx() method attaches the specified file to the message.

 

If the specified message is not a multipart message, it is marked as multipart and the attached file is appended to the message. If the message is already a multipart message, an additonal part is created and the attachment is added to the message.

 

Values for nOptions are:

MIME_ATTACH_DEFAULT

The file attachment encoding is based on the file content type. Text files are not encoded, and binary files are encoded using the standard base64 encoding algorithm. This is the default option for file attachments.

MIME_ATTACH_BASE64

The file attachment is always encoded using the standard base64 algorithm, even if the attached file is a plain text file.

MIME_ATTACH_UUCODE

The file attachment is always encoded using the uuencode algorithm, even if the attached file is a plain text file.

 

 

See Also

:AttachFile(), :ExportMessage(), :ExtractFile(), :GetAttachedFileName(), :ImportMessage()