Error Messages Returned by MCFGetMail Class Methods

The GetMail Integration Broker connector returns message codes denoting status. These return codes apply to all the methods within the MCFGetMail class. The following are returned in MCF_RET_STATUS field, and by the Status property.

Field or Control	Description
0	Success.
1	Connector size overflow. The size of the email requested exceeds the value in MCF_EmSz_Conn. The system returns the header information for this email with the return status set to 1. See MultiChannel Framework: Configuring GETMAILTARGET Connector Properties.
2	Integration Broker threshold size overflow. The size of the email requested exceeds the value in MCF_EmSz_IB. This happens when the size of the XML message constructed to transfer emails from the mail server to the database exceeds the threshold value. If there are any more emails to be processed in the current batch, the system does not fetch them from the mail server. For example, suppose your program fetches 20 emails at a time from the mail server, and this error occurred on the tenth email. In this case, the system processes the tenth email, but emails 11–20 are still be on the mail server. See MultiChannel Framework: Configuring GETMAILTARGET Connector Properties.
3	Cannot delete all the messages from the mail server.
4	Connecting to the mail server failed.
5	The attachments to be deleted were not found.
6	At least one attachment cannot be deleted.
7	Unsupported encoding.
8	Cannot write to the attachment directory.
9	Messages were downloaded to directory and deleted from mail server. This status code occurs when an exception occurs in Integration Broker while storing the emails to the database. The exception might occur due to invalid characters in the email. If the email is left on the mail server, the same exception will occur repeatedly, preventing you from fetching further emails. Because the header might contain these invalid characters also, only MCF_RET_STATUS, MCF_MSG_SIZE, MCF_UID_LIST, date time fields, MCF_IS_ATT_URL, MCF_ATT_URL are set. There is no way to determine which email caused the exception, so the system writes all the emails to the directory. All the emails in the batch are deleted from the mail server.

Field or Control	Description
10	Email content error. One example of this is unsupported encoding.

Field or Control	Description
11	Returned if attempting to create a mail server folder while using the POP3 protocol.
12	Folder creation on mail server failed.
13	GetMail connector internal error.
14	Email digital signature not verified. Note: This error code only applies to reading digitally signed emails (or emails that are both signed and encrypted).
15	An error occurred while attempting to decrypt or decode S/MIME data. Note: This error code only applies to reading digitally signed emails (or emails that are both signed and encrypted).

See Status property: MCFInboundEmail class.