(PowerBuilder) POP3: Download Most Recent Email (method 1)

How to ready the N most recent email from a POP3 server.

The POP3 protocol does not provide the ability to request the most recent email, nor does it provide the ability to download email based on read/unread status or any other criteria. The design principle behind POP3 is that it is a temporary holding store for incoming email and email clients or other applications will transfer email from the POP3 server to a local persistent store where it will be managed. Therefore, POP3 does not provide sophisticated functionality (as opposed to IMAP which has the opposite design philosophy: that email is maintained and organized on the server).

This example shows one possible way to retrieve the N most recent emails from a POP3 server. It downloads the headers into a bundle object, then sorts the bundle by date, and finally retrieves the most recent emails by UIDL.

Another alternative is to download the UIDL list and then assume that the 1st N UIDLs are the most recent.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

integer li_rc
oleobject loo_Mailman
integer li_Success
oleobject loo_Bundle
integer li_Ascending
oleobject loo_SaUidls
integer n
integer i
oleobject loo_Email
oleobject loo_Bundle2

// 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
// Use "Chilkat_9_5_0.MailMan" for versions of Chilkat < 10.0.0
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.someMailServer.com"

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

// Read mail headers and one line of the body.
loo_Bundle = loo_Mailman.GetAllHeaders(1)
if loo_Mailman.LastMethodSuccess = 0 then
    Write-Debug loo_Mailman.LastErrorText
    destroy loo_Mailman
    return
end if

// Sort the bundle by date
li_Ascending = 0
loo_Bundle.SortByDate(li_Ascending)

// Get the 10 most recent UIDLs
loo_SaUidls = create oleobject
// Use "Chilkat_9_5_0.StringArray" for versions of Chilkat < 10.0.0
li_rc = loo_SaUidls.ConnectToNewObject("Chilkat.StringArray")

n = loo_Bundle.MessageCount
if n > 10 then
    n = 10
end if

i = 0

do while i < n
    loo_Email = loo_Bundle.GetEmail(i)
    li_Success = loo_SaUidls.Append(loo_Email.Uidl)
    destroy loo_Email

    i = i + 1
loop

destroy loo_Bundle

// Download in full the 10 most recent emails:
loo_Bundle2 = loo_Mailman.FetchMultiple(loo_SaUidls)
if loo_Mailman.LastMethodSuccess = 0 then
    Write-Debug loo_Mailman.LastErrorText
    destroy loo_Mailman
    destroy loo_SaUidls
    return
end if

i = 0
do while i < loo_Bundle2.MessageCount
    loo_Email = loo_Bundle2.GetEmail(i)
    Write-Debug loo_Email.From
    Write-Debug loo_Email.Subject
    Write-Debug "----"
    destroy loo_Email

    i = i + 1
loop


destroy loo_Mailman
destroy loo_SaUidls