(PureBasic) Send Email and Put Copy in "Sent" Folder

This example demonstrates how to send an email, and then put a copy of it in the "Sent" mail folder. This is only possible if the "Sent" folder is located on the mail server and accessed via the IMAP protocol. The POP3 protocol can only access the Inbox on the mail server.

This does not work with "Sent", "Sent Items", or "Sent Messages" folders that are stored locally on your computer by an email client such as Outlook or Thunderbird. Chilkat has no ability to copy email to the local files managed by these email clients.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkImap.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

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

    success.i

    ; The mailman object is used for sending and receiving email.
    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Set the SMTP server.
    CkMailMan::setCkSmtpHost(mailman, "smtp.my-mail-server.com")

    ; Set the SMTP login/password (if required)
    CkMailMan::setCkSmtpUsername(mailman, "myUsername")
    CkMailMan::setCkSmtpPassword(mailman, "myPassword")

    ; Create a new email object
    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "This is a test")
    CkEmail::setCkBody(email, "This is a test")
    CkEmail::setCkFrom(email, "Chilkat Support <support@chilkatsoft.com>")
    CkEmail::ckAddTo(email,"Chilkat Admin","admin@chilkatsoft.com")
    ; To add more recipients, call AddTo, AddCC, or AddBcc once per recipient.

    ; Call SendEmail to connect to the SMTP server and send.
    success = CkMailMan::ckSendEmail(mailman,email)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mailman)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ; Some SMTP servers do not actually send the email until 
    ; the connection is closed.  In these cases, it is necessary to
    ; call CloseSmtpConnection for the mail to be  sent.  
    ; Most SMTP servers send the email immediately, and it is 
    ; not required to close the connection.  We'll close it here
    ; for the example:
    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Connection to SMTP server not closed cleanly."

    EndIf

    Debug "Mail Sent!"

    ; The mail has been sent.  Now save the email to the "Sent" folder
    ; on your mail server.  (Your "Sent" folder could be named something else,
    ; or you may store the email in any folder of your choosing.)
    imap.i = CkImap::ckCreate()
    If imap.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Connect to an IMAP server.
    ; Use TLS
    CkImap::setCkSsl(imap, 1)
    CkImap::setCkPort(imap, 993)
    success = CkImap::ckConnect(imap,"imap.my-mail-server.com")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; Login
    success = CkImap::ckLogin(imap,"myLogin","myPassword")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; Upload (save) the email to the "Sent" mailbox.
    success = CkImap::ckAppendMail(imap,"Sent",email)
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkMailMan::ckDispose(mailman)
        CkEmail::ckDispose(email)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    Debug "Email saved to the Sent folder."

    ; Disconnect from the IMAP server.
    success = CkImap::ckDisconnect(imap)


    CkMailMan::ckDispose(mailman)
    CkEmail::ckDispose(email)
    CkImap::ckDispose(imap)


    ProcedureReturn
EndProcedure