(PureBasic) Scan for Emails with Attachments and Save Attachments to Files

Scan for emails with attachments and save attachments.

Chilkat PureBasic Module Download Chilkat PureBasic Module

IncludeFile "CkImap.pb"
IncludeFile "CkEmailBundle.pb"
IncludeFile "CkMessageSet.pb"
IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

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

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

    messageSet.i
    ; We can choose to fetch UIDs or sequence numbers.
    fetchUids.i = 1

    ; Get the message IDs of all the emails in the mailbox
    messageSet = CkImap::ckSearch(imap,"ALL",fetchUids)
    If CkImap::ckLastMethodSuccess(imap) <> 1
        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; Fetch the email headers into a bundle object:
    bundle.i
    bundle = CkImap::ckFetchHeaders(imap,messageSet)
    If CkImap::ckLastMethodSuccess(imap) <> 1
        CkMessageSet::ckDispose(messageSet)

        Debug CkImap::ckLastErrorText(imap)
        CkImap::ckDispose(imap)
        ProcedureReturn
    EndIf

    ; Scan for emails with attachments, and save the attachments
    ; to a sub-directory.
    i.i
    For i = 0 To CkEmailBundle::ckMessageCount(bundle) - 1
        email.i
        email = CkEmailBundle::ckGetEmail(bundle,i)

        ; Does this email have attachments?
        ; Use GetMailNumAttach because the attachments
        ; are not actually in the email object because
        ; we only downloaded headers.
        ; (Had we downloaded the full emails by
        ; calling mailman.FetchBundle, we could look
        ; at the email object's NumAttachments property.)
        numAttach.i = CkImap::ckGetMailNumAttach(imap,email)

        If numAttach > 0
            ; Download the entire email and save the
            ; attachments. (Remember, we 
            ; need to download the entire email because
            ; only the headers were previously downloaded.
            ; If the entire emails were downloaded by
            ; calling FetchBundle instead of FetchHeaders,
            ; this would not be necessary.

            ; The ckx-imap-uid header field is added when
            ; headers are downloaded.  This makes it possible
            ; to get the UID from the email object.
            uidStr.s = CkEmail::ckGetHeaderField(email,"ckx-imap-uid")
            uid.i = Val(uidStr)

            fullEmail.i
            fullEmail = CkImap::ckFetchSingle(imap,uid,1)
            If CkImap::ckLastMethodSuccess(imap) = 1
                success = CkEmail::ckSaveAllAttachments(fullEmail,"attachmentsDir")
                CkEmail::ckDispose(fullEmail)

            EndIf

            j.i
            For j = 0 To numAttach - 1
                filename.s = CkImap::ckGetMailAttachFilename(imap,email,j)
                Debug filename
            Next

        EndIf

        CkEmail::ckDispose(email)

    Next

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

    CkMessageSet::ckDispose(messageSet)

    CkEmailBundle::ckDispose(bundle)



    CkImap::ckDispose(imap)


    ProcedureReturn
EndProcedure