(Lianja) 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.

Chilkat Lianja Extension Download Chilkat Lianja Extension

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

loImap = createobject("CkImap")

// Connect to an IMAP server.
// Use TLS
loImap.Ssl = .T.
loImap.Port = 993
llSuccess = loImap.Connect("imap.someMailServer.com")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    return
endif

// Login
llSuccess = loImap.Login("myLogin","myPassword")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    return
endif

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

// 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

loEmail = createobject("CkEmail")

// Load the email from a .eml file.
llSuccess = loEmail.LoadEml("myEmail.eml")
if (llSuccess <> .T.) then
    ? loEmail.LastErrorText
    release loImap
    release loEmail
    return
endif

llSuccess = loImap.AppendMail("Inbox",loEmail)
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    release loEmail
    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(loImap.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.
llSuccess = loImap.SelectMailbox("Inbox")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    release loEmail
    return
endif

lnUidNext = loImap.UidNext

llSuccess = loImap.AppendMail("Inbox",loEmail)
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    release loEmail
    return
endif

? "The UID of the appended email SHOULD be " + str(lnUidNext)

? "Email uploaded to Inbox!"

// Disconnect from the IMAP server.
llSuccess = loImap.Disconnect()


release loImap
release loEmail