Options Property

Sets or returns various message options.

Syntax

object.Options [= value ]

Remarks

The Options is a numeric value that specifies various message export options. By default, the Received and Return-Path headers are not exported. In addition, the order of the headers in an exported message is undefined. This is reasonable behavior for most mail clients, but may not be appropriate for applications the implement or extend a mail server.

One or more of the following options may be specified:

Value Constant Description
0 mimeOptionDefault The default options for exporting messages. The headers for the message are written out in a specific consistent order, with custom headers written to the end of the header block regardless of the order in which they were set or imported from another message. If the message contains Bcc, Received, Return-Path, Status or X400-Received header fields, they will not be exported.
1 mimeOptionAllHeaders All headers, including the Bcc, Received, Return-Path, Status and X400-Received header fields will be exported. Normally these headers are not exported because they are only used by the mail transport system. This option can be useful when exporting a message to be stored on the local system, but should not be used when exporting a message to be delivered to another user.
2 mimeOptionKeepOrder The original order in which the message header fields were set or imported are preserved when the message is exported.

To combine multiple options, use a bitwise operator. To test if an option has been previously set, use the bitwise And operator.

Data Type

Integer

Example

MailMessage1.Options = mimeOptionAllHeaders Or MimeOptionKeepOrder
MailMessage1.ImportMessage "mail.eml"
MailMessage1.Subject = "This is a new subject"
MailMessage1.ExportMessage "newmail.eml"

See Also

ExportMessage Method, ImportMessage Method


Copyright © 2008 Catalyst Development Corporation. All rights reserved.