PowerBuilder
PowerBuilder
Fetch a Range of POP3 Messages
See more POP3 Examples
Demonstrates the Chilkat MailMan.FetchRange method, which retrieves a range of messages from the POP3 mailbox and appends them to an EmailBundle. The arguments are keepOnServer, headersOnly, numBodyLines, a zero-based inclusive startIndex and endIndex, and the EmailBundle. This example fetches the first five messages.
Background: Fetching a range instead of everything is useful for paging through a large mailbox, or resuming after an interruption — download messages 0–99, then 100–199, and so on. Combined with
headersOnly, it lets you build a quick message-list view without pulling full bodies and attachments up front.Chilkat PowerBuilder Downloads
integer li_rc
integer li_Success
oleobject loo_Mailman
oleobject loo_Bundle
integer n
oleobject loo_Email
integer i
li_Success = 0
// Demonstrates the MailMan.FetchRange method, which retrieves a range of messages from the
// POP3 mailbox and appends them to an EmailBundle. The arguments are keepOnServer,
// headersOnly, numBodyLines, startIndex, endIndex, and the EmailBundle. The indexes are
// zero-based and inclusive.
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
// Configure the POP3 server connection.
loo_Mailman.MailHost = "pop.example.com"
loo_Mailman.MailPort = 995
loo_Mailman.PopSsl = 1
loo_Mailman.PopUsername = "user@example.com"
loo_Mailman.PopPassword = "myPassword"
// Fetch the first 5 messages (indexes 0 through 4), full bodies, leaving them on the server.
// keepOnServer=1, headersOnly=0 (fetch the entire message).
// Note: numBodyLines only applies when headersOnly is 1 (it sets how many lines of the
// body to include along with the headers). When headersOnly is 0, the entire message
// is fetched and numBodyLines is ignored.
loo_Bundle = create oleobject
li_rc = loo_Bundle.ConnectToNewObject("Chilkat.EmailBundle")
li_Success = loo_Mailman.FetchRange(1,0,0,0,4,loo_Bundle)
if li_Success = 0 then
Write-Debug loo_Mailman.LastErrorText
destroy loo_Mailman
destroy loo_Bundle
return
end if
n = loo_Bundle.MessageCount
Write-Debug "Fetched " + string(n) + " messages."
loo_Email = create oleobject
li_rc = loo_Email.ConnectToNewObject("Chilkat.Email")
for i = 0 to n - 1
li_Success = loo_Bundle.EmailAt(i,loo_Email)
Write-Debug loo_Email.Subject
next
// Note: Explicitly connecting/authenticating is optional. Chilkat MailMan automatically
// connects and authenticates -- using the property settings above -- whenever a server
// operation requires it. Calling the explicit connect/authenticate methods can still be
// helpful to determine whether a failure occurs while connecting or while authenticating.
destroy loo_Mailman
destroy loo_Bundle
destroy loo_Email