Sample code for 30+ languages & platforms
PureBasic Requires Chilkat v11.0.0+

Preview POP3 messages and download a complete email

See more Email Object Examples

Read a short preview for each of up to five messages into an EmailBundle, print their subjects, and download the complete first entry into a separate Email. Configure a POP3 account that supports UIDL and TOP. All messages stay on the server.

Chilkat PureBasic Downloads

PureBasic
IncludeFile "CkEmailBundle.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkMailMan.pb"

Procedure ChilkatExample()

    success.i = 0

    ;  Assumes Chilkat is unlocked. See Global Unlock Sample.

    mail.i = CkMailMan::ckCreate()
    If mail.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkMailMan::setCkMailHost(mail, "pop.example.com")
    CkMailMan::setCkMailPort(mail, 995)
    CkMailMan::setCkPopSsl(mail, 1)
    CkMailMan::setCkRequireSslCertVerify(mail, 1)
    CkMailMan::setCkPopUsername(mail, "MAIL_USER")
    CkMailMan::setCkPopPassword(mail, "MAIL_PASSWORD")
    previews.i = CkEmailBundle::ckCreate()
    If previews.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    ;  Keep the messages and request minimal previews. Range indexes are zero-based and inclusive.
    success = CkMailMan::ckFetchRange(mail,1,1,0,0,4,previews)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mail)
        CkMailMan::ckDispose(mail)
        CkEmailBundle::ckDispose(previews)
        ProcedureReturn
    EndIf

    If CkEmailBundle::ckMessageCount(previews) = 0
        Debug "There are no messages to preview."
        success = CkMailMan::ckPop3EndSession(mail)
        If success <> 1
            Debug CkMailMan::ckLastErrorText(mail)
            CkMailMan::ckDispose(mail)
            CkEmailBundle::ckDispose(previews)
            ProcedureReturn
        EndIf

        CkMailMan::ckDispose(mail)
        CkEmailBundle::ckDispose(previews)
        ProcedureReturn
    EndIf

    header.i = CkEmail::ckCreate()
    If header.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    i.i = 0
    While (i < CkEmailBundle::ckMessageCount(previews))
        success = CkEmailBundle::ckEmailAt(previews,i,header)
        If success <> 1
            Debug CkEmailBundle::ckLastErrorText(previews)
            CkMailMan::ckDispose(mail)
            CkEmailBundle::ckDispose(previews)
            CkEmail::ckDispose(header)
            ProcedureReturn
        EndIf

        Debug CkEmail::ckUidl(header) + "  " + CkEmail::ckSubject(header)
        i = i + 1
    Wend
    ;  A UI could use its selected row here. FetchFull uses the preview's POP3 identity.
    success = CkEmailBundle::ckEmailAt(previews,0,header)
    If success <> 1
        Debug CkEmailBundle::ckLastErrorText(previews)
        CkMailMan::ckDispose(mail)
        CkEmailBundle::ckDispose(previews)
        CkEmail::ckDispose(header)
        ProcedureReturn
    EndIf

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

    success = CkMailMan::ckFetchFull(mail,header,email)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mail)
        CkMailMan::ckDispose(mail)
        CkEmailBundle::ckDispose(previews)
        CkEmail::ckDispose(header)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    success = CkMailMan::ckPop3EndSession(mail)
    If success <> 1
        Debug CkMailMan::ckLastErrorText(mail)
        CkMailMan::ckDispose(mail)
        CkEmailBundle::ckDispose(previews)
        CkEmail::ckDispose(header)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    Debug "Full message: " + CkEmail::ckSubject(email) + "  Files: " + Str(CkEmail::ckNumAttachments(email))

    success = CkEmail::ckSaveEml(email,"pop-received.eml")
    If success <> 1
        Debug CkEmail::ckLastErrorText(email)
        CkMailMan::ckDispose(mail)
        CkEmailBundle::ckDispose(previews)
        CkEmail::ckDispose(header)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    Debug "Saved pop-received.eml."


    CkMailMan::ckDispose(mail)
    CkEmailBundle::ckDispose(previews)
    CkEmail::ckDispose(header)
    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure