Distinct VIT: MIME Control: OnError

Summary

Local error has occurred.

Description

The OnError event occurs when a property is accessed in an illegal way or when a connection with the remote server cannot be established. The table below lists all possible error codes delivered by this event.

The following describes each error in more detail.

ERR_CANNOT_PERFORM_ACTION
Unable to initialize the underlying Distinct support files. There may be a license violation.

ERR_IN_ACTION
Another action is already in progress.

ERR_CANNOT_ABORT
The Abort method or the Action property can only be set to ACTION_ABORT while creating a message (using ACTION_CREATE). ACTION_ABORT or the Abort method cannot be used under any other circumstances.

ERR_CANNOT_CREATE
The create message (by setting the Action property to ACTION_CREATE or by calling the Create method) failed. Make sure that the mandatory properties are set and the Destination property has a correct value.

ERR_CANNOT_EXTRACT
The extract message (by setting the Action property to ACTION_EXTRACT or by calling the Extract method) failed. The Destination property must be set to a directory name.

ERR_CANNOT_UUENCODE
UUencode (by setting the Action property to ACTION_UUENCODE or by calling the UUencode method) failed. Please set the FileName, Source and Destination properties correctly.

ERR_CANNOT_UUDECODE
UUdecode (by setting the Action property to ACTION_UUDECODE or by calling the UUdecode method) failed. Please set the Source and Destination properties correctly.

ERR_CANNOT_BASE64_ENCODE
Base64 encode (by setting the Action property to ACTION_BASE64_ENCODE or by calling the Base64Encode method) failed. Please set the FileName, Source and Destination properties correctly.

ERR_CANNOT_BASE64_DECODE
Base64 decode (by setting the Action property to ACTION_BASE64_DECODE or by calling the Base64Decode method) failed. Please set the Source and Destination properties correctly.

ERR_CANNOT_QUOTED_ENCODE
Quoted-printable encode (by setting the Action property to ACTION_QUOTED_ENCODE or by calling the QuotedEncode method) failed. Please set the FileName, Source and Destination properties correctly.

ERR_CANNOT_QUOTED_DECODE
Quoted-printable decode (by setting the Action property to ACTION_QUOTED_DECODE or by calling the QuotedDecode method) failed. Please set the Source and Destination properties correctly.

ERR_PARTIAL_MESSAGE
One part of a partial message was extracted. This is not an error but simply informational. When all the parts are extracted, the MIME control will reassemble the message and fire the OnExtract event with all the information.

ERR_IN_CREATE
During message create, the UseVariant property cannot be changed.

ERR_MIME_ABORTED
Action was aborted by application. The Action property was set to ACTION_ABORT or the Abort method was called.

ERR_MIME_OUT_OF_MEMORY
Not enough memory to perform action.

ERR_MIME_FILE_ERROR
File I/O error. Unable to write, read or create file.

ERR_MIME_CANNOT_BINHEX_DECODE
BinHex decoding failed. Check that the Src and Destination parameters (or properties if the Action property is set to ACTION_BINHEX_ENCODE.) are set correctly.

ERR_MIME_INVALID_ENCODING
The encoding type set in the OnSetAddrField event is invalid. The encoding parameter must be set to either ADDR_BASE64_ENCODED, ADDR_QUOTED_ENCODED or ADDR_NO_ENCODING.

ERR_MIME_INVALID_FIELD
The field parameter set in the OnSetAddrField event is invalid. The field parameter must be set to "To", "From", "Subject", "Bcc" or "Cc". The field parameter is not case sensitive.

ERR_MIME_NO_ADDR_FIELD
The message address fields have not been correctly set in the OnSetAddrField event during the create message process.The OnSetAddrField event must be used to set a minimum of the "To" and "From" fields before a message can be successfully created.

ERR_MIME_INVALID_DEST
The CreateMessage Dest parameter must be set to a null or empty string, or a valid filename (including the full path).

ERR_MIME_ENCODING_ERROR
An encoding error occurred while creating a message. The ContentType and SubType properties must be set before calling the CreateMessage method.

ERR_MIME_DATA_ERROR
Error in sending or receiving data.

ERR_MIME_EXTRACT_START_FAILED
The ExtractMessageStart method failed. The Dest parameter must be either a null or empty string, or an existing directory.

ERR_MIME_INVALID_MSG_HANDLE
The ExtractMessageStart method must be called successfully for the MIME ActiveX control to receive a message handle. This must happen before the ExtractMessageData and ExtractMessageEnd methods can be called.

ERR_MIME_INVALID_VARIANT_TYPE
An invalid variant type is being passed to the ExtractMessageData method. See the ExtractMessageData method for information on which variant types are supported.

ERR_MIME_DECODING_ERROR
A decoding error occurred while extracting a message.

ERR_MIME_ASSEMBLY_ERROR
There has been an error while assembling the parts of a partial message.

Example

Sub Mime_OnError (ErrorCode As Integer)
If ErrorCode = ERR_CANNOT_CREATE Then
MsgBox "Unable to create message", 64, "Sample Program"
End If
End Sub

"Together with Distinct, we were able to offer our users an ideal soution to enabling them to connect to Yahoo! Pager, and to do so both quickly and reliably." [more]
Brian Park,
Producer of Yahoo! Pager, Yahoo! Inc.