(PureBasic) Forward by Attaching the Existing Email to a New Email

Demonstrates how to forward an email by attaching the email to a new email. This example uses the AttachEmail method, which is new in Chilkat v9.5.0.87.

This example reads an email from an IMAP server, attaches the email to a new email, and sends the new email.

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.

    ; Read the 1st (most recent) email in an Inbox.
    imap.i = CkImap::ckCreate()
    If imap.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ; Connect to an IMAP server.
    CkImap::setCkSsl(imap, 1)
    CkImap::setCkPort(imap, 993)
    success.i = CkImap::ckConnect(imap,"imap.someMailServer.com")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

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

    ; Select an IMAP mailbox
    success = CkImap::ckSelectMailbox(imap,"Inbox")
    If success <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    numEmails.i = CkImap::ckNumMessages(imap)

    ; Fetch the email at the last sequence number.
    ; (We are assuming the Inbox has at least 1 email)
    email.i = CkImap::ckFetchSingle(imap,numEmails,0)
    If CkImap::ckLastMethodSuccess(imap) = 0
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

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

    Debug CkEmail::ckSubject(email)

    ; Create a new email.  The email we just read will be attached to this email.
    eForward.i = CkEmail::ckCreate()
    If eForward.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::ckAddTo(eForward,"Chilkat Support","support@chilkatsoft.com")

    CkEmail::setCkFromAddress(eForward, "matt@someMailServer.com")
    CkEmail::setCkFromName(eForward, "Matt")
    CkEmail::setCkSubject(eForward, "This is an email with another email attached.")

    CkEmail::ckSetHtmlBody(eForward,"<p>Hello, this is an email I'm forwarding to you.  See the attached email.</p>")

    ; Attach the email.
    CkEmail::ckAttachEmail(eForward,email)

    ; We could save the .eml, then double-click on it to view in our mail program, such as Outlook or Thunderbird..
    CkEmail::ckSaveEml(eForward,"qa_output/forward.eml")

    ; We could send (forward) the email..
    mailman.i = CkMailMan::ckCreate()
    If mailman.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkMailMan::setCkSmtpHost(mailman, "smtp.someMailServer.com")
    CkMailMan::setCkSmtpUsername(mailman, "myLogin")
    CkMailMan::setCkSmtpPassword(mailman, "myPassword")
    CkMailMan::setCkSmtpPort(mailman, 587)
    CkMailMan::setCkStartTLS(mailman, 1)

    success = CkMailMan::ckSendEmail(mailman,eForward)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mailman)
        CkImap::ckDispose(imap)
        CkEmail::ckDispose(eForward)
        CkMailMan::ckDispose(mailman)
        ProcedureReturn
    EndIf

    success = CkMailMan::ckCloseSmtpConnection(mailman)
    If success <> 1
        Debug "Connection to SMTP server not closed cleanly."
    EndIf

    Debug "Mail Sent!"

    CkEmail::ckDispose(email)



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


    ProcedureReturn
EndProcedure