Xbase++

Upload (Append) Email to an IMAP Mailbox and get the UID of the Appended Email

Upload / append an email to an IMAP mailbox and get the UID of the appended email. Xbase++

LOCAL nSuccess
LOCAL oImap
LOCAL cCap
LOCAL oEmail
LOCAL nUidNext

nSuccess := 0

//  This example assumes the Chilkat API to have been previously unlocked.
//  See Global Unlock Sample for sample code.

oImap := CreateObject("Chilkat.Imap")

//  Connect to an IMAP server.
//  Use TLS
oImap:Ssl := 1
oImap:Port := 993
nSuccess := oImap:Connect("imap.example.com")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    RETURN
ENDIF

//  Login
nSuccess := oImap:Login("myLogin", "myPassword")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    RETURN
ENDIF

//  Check the capabilities of the IMAP server.
cCap := oImap:Capability()
? "IMAP capabilities: " + cCap

//  If the capabilities string contains the substring "UIDPLUS", then 
//  the UID of the appended email will be available in the AppendUid property (see below).

//  For example, the GMail IMAP server has these capabilities (at this current time)
//  * CAPABILITY IMAP4rev1 UNSELECT IDLE NAMESPACE QUOTA ID XLIST CHILDREN 
//  X-GM-EXT-1 UIDPLUS COMPRESS=DEFLATE ENABLE MOVE CONDSTORE ESEARCH UTF8=ACCEPT 
//  APPENDLIMIT=35882577 LIST-EXTENDED LIST-STATUS

oEmail := CreateObject("Chilkat.Email")

//  Load the email from a .eml file.
nSuccess := oEmail:LoadEml("myEmail.eml")
IF (nSuccess != 1)
    ? oEmail:LastErrorText
    oImap:destroy()
    oEmail:destroy()
    RETURN
ENDIF

nSuccess := oImap:AppendMail("Inbox", oEmail)
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    oEmail:destroy()
    RETURN
ENDIF

//  If the IMAP server supports the UIDPLUS extension, then the 
//  imap.AppendUid will contain the UID of the appended email.
//  Otherwise AppendUid will be 0.
? "UID of appended email: " + Str(oImap:AppendUid)

//  If the IMAP server does NOT have UIDPLUS, then a program can 
//  first select the mailbox, get the value of the UidNext property,
//  and then append.  The appended email SHOULD have a UID equal to 
//  the UidNext that was obtained just prior to appending (assuming no other
//  program is simultaneously appending an email to the same mailbox).

//  Note: It is not required to select a mailbox to append.  The select is only
//  done for the purpose of obtaining the UIDNEXT value.
nSuccess := oImap:SelectMailbox("Inbox")
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    oEmail:destroy()
    RETURN
ENDIF

nUidNext := oImap:UidNext

nSuccess := oImap:AppendMail("Inbox", oEmail)
IF (nSuccess != 1)
    ? oImap:LastErrorText
    oImap:destroy()
    oEmail:destroy()
    RETURN
ENDIF

? "The UID of the appended email SHOULD be " + Str(nUidNext)

? "Email uploaded to Inbox!"

//  Disconnect from the IMAP server.
nSuccess := oImap:Disconnect()

oImap:destroy()
oEmail:destroy()