Store Method

Description

Store a message in a file.

Syntax

Visual Basic
Public Sub Store( _ ByVal File As String, _ Optional ByVal Format As FormatConstants = msgEncoded _ )

Visual Basic

Public Sub Store( _
   ByVal File As String, _
   Optional ByVal Format As FormatConstants = msgEncoded _
)

Parameters

File

Contains the fully qualified filename to be created.

Format

Value	Description
msgDecoded	Store the decoded object model version of the message.
msgEncoded	Store the encoded "transport-ready" version of the message.

Specifies the format of the saved message. Defaults to msgEncoded.

Remarks

If the Format parameter is msgEncoded or unspecified, the message will be stored as a transport ready file containing the encoded message.

If the Format parameter is msgDecoded the message will be stored in an object format. These files are smaller and quicker to read and write then an encoded file. Decoded files store attached files externally. In addition, data is stored as 8-bit data instead of the 7-bit data used in msgEncoded format. This results in smaller files and there is no decoding required when the file is loaded (see the Load method).

Error Codes

This method may generate the following error code (refer to MailErrorConstants for a complete list of error codes):

ptFile
ptInvalidParam2
ptNoBufferSpace