PowerBuilder

Download and Save Email Attachments (POP3)

See more POP3 Examples

Downloads emails from a POP3 mailbox and saves all attachments. PowerBuilder

integer li_rc
integer li_Success
oleobject loo_Mailman
oleobject loo_Bundle
integer li_KeepOnServer
integer li_HeadersOnly
integer li_NumBodyLines
string ls_DirPath
oleobject loo_Email
integer li_BundleIndex
integer li_NumMessages
integer li_NumAttachments
integer li_AttachIndex

li_Success = 0

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

// The mailman object is used for receiving (POP3) 
// and sending (SMTP) email.
loo_Mailman = create oleobject
li_rc = loo_Mailman.ConnectToNewObject("Chilkat.MailMan")
if li_rc < 0 then
    destroy loo_Mailman
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Set the POP3 server's hostname
loo_Mailman.MailHost = "pop.yourserver.com"

// Set the POP3 login/password.
loo_Mailman.PopUsername = "***"
loo_Mailman.PopPassword = "***"

// Copy the all email from the user's POP3 mailbox 
// into a bundle object.  The email remains on the server.
// FetchAll is a reasonable choice for POP3 maildrops that don't have too many
// emails. For larger mail drops, one might download emails one at a time..
loo_Bundle = create oleobject
li_rc = loo_Bundle.ConnectToNewObject("Chilkat.EmailBundle")

li_KeepOnServer = 1
li_HeadersOnly = 0
// Irrelevent because we are NOT downloading headers-only
li_NumBodyLines = 0
li_Success = loo_Mailman.FetchAll(li_KeepOnServer,li_HeadersOnly,li_NumBodyLines,loo_Bundle)
if li_Success = 0 then
    Write-Debug loo_Mailman.LastErrorText
    destroy loo_Mailman
    destroy loo_Bundle
    return
end if

// The directory path can be relative or absolute.
// This shows a Windows style directory path.  On other operating systems, the path
// would be different..
ls_DirPath = "c:/myAttachments"

loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")

li_BundleIndex = 0
li_NumMessages = loo_Bundle.MessageCount

do while (li_BundleIndex < li_NumMessages)
    loo_Bundle.EmailAt(li_BundleIndex,loo_Email)

    // Save all attachments to the specified directory.
    // The directory is automatically created if it does not yet exist.
    li_Success = loo_Email.SaveAllAttachments(ls_DirPath)
    if li_Success = 0 then
        Write-Debug loo_Email.LastErrorText
        destroy loo_Mailman
        destroy loo_Bundle
        destroy loo_Email
        return
    end if

    // The OverwriteExisting property controls whether already-existing files
    // are automatically overwritten.  By default, it is set to 1 so that existing
    // files will be overwritten.

    // Setting OverwriteExisting = 0 will cause the attachment-saving methods to generate
    // unique filenames if a file with the same name already exists.  The actual filename(s)
    // saved will be present by calling GetAttachmentFilename for each attachment *after*
    // saving.
    // For example...
    loo_Email.OverwriteExisting = 0
    li_Success = loo_Email.SaveAllAttachments(ls_DirPath)
    if li_Success = 0 then
        Write-Debug loo_Email.LastErrorText
        destroy loo_Mailman
        destroy loo_Bundle
        destroy loo_Email
        return
    end if

    li_NumAttachments = loo_Email.NumAttachments
    li_AttachIndex = 0
    do while (li_AttachIndex < li_NumAttachments)
        // If the attachment filename was changed to prevent overwriting,
        // GetAttachmentFilename will return the new filename.
        Write-Debug loo_Email.GetAttachmentFilename(li_AttachIndex)
        li_AttachIndex = li_AttachIndex + 1
    loop

    // Attachments can also be saved individually.
    li_AttachIndex = 0
    do while (li_AttachIndex < li_NumAttachments)

        Write-Debug "Original Filename: " + loo_Email.GetAttachmentFilename(li_AttachIndex)
        li_Success = loo_Email.SaveAttachedFile(li_AttachIndex,ls_DirPath)
        if li_Success = 0 then
            Write-Debug loo_Email.LastErrorText
            destroy loo_Mailman
            destroy loo_Bundle
            destroy loo_Email
            return
        end if

        // If OverwriteExisting = 1, the saved filename will always equal the original filename,
        // unless there are characters present in the filename that are not allowed by Windows,
        // such as * ? < > | etc.  In those cases the illegal characters are either removed or replaced
        // with underscore characters to allow the file to be saved.
        Write-Debug "Saved Filename: " + loo_Email.GetAttachmentFilename(li_AttachIndex)
        li_AttachIndex = li_AttachIndex + 1
    loop

    li_BundleIndex = li_BundleIndex + 1
loop


destroy loo_Mailman
destroy loo_Bundle
destroy loo_Email