AppendToMailbox Method

Appends the message in MessageText to the mailbox specified by Mailbox .

Syntax

ANSI (Cross Platform)
int AppendToMailbox();

Unicode (Windows)
INT AppendToMailbox();
- (void)appendToMailbox;
#define MID_IMAP_APPENDTOMAILBOX 3

IPWORKS_EXTERNAL int IPWORKS_CALL IPWorks_IMAP_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method appends the RFC822-encoded message in MessageText to the mailbox specified by Mailbox. If the MessageFlags property is not an empty string, it's contents are supplied with the 'APPEND' command sent to the server.

Example (Append Message to Mailbox)


IMAPControl.MessageText = MessageHeaders + CRLF + CRLF + MessageBody + CRLF
IMAPControl.Mailbox = "INBOX"
IMAPControl.MessageFlags = "\Deleted"
IMAPControl.AppendToMailbox()

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)
Copyright (c) 2022 /n software inc. - All rights reserved.
IPWorks 2020 C++ Edition - Version 20.0 [Build 8307]