(PowerBuilder) Fetch 1st N Headers of Search Results

Calls Search to get a message set, then downloads the 1st N messages in the message set. There are two equivalent ways of doing it: (1) iterate from 0 to N-1 and download each message individually, or (2) create a new message set that contains the 1st N messages and pass it to FetchHeaders. Both are demonstrated here.

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

integer li_rc
oleobject loo_Imap
integer li_Success
oleobject loo_MessageSet
integer li_FetchUids
integer li_NumFound
integer li_UpperBound
integer i
integer li_BUid
oleobject loo_Email
oleobject loo_FirstTen
oleobject loo_Bundle

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

loo_Imap = create oleobject
// Use "Chilkat_9_5_0.Imap" for versions of Chilkat < 10.0.0
li_rc = loo_Imap.ConnectToNewObject("Chilkat.Imap")
if li_rc < 0 then
    destroy loo_Imap
    MessageBox("Error","Connecting to COM object failed")
    return
end if

// Connect to an IMAP server.
// Use TLS
loo_Imap.Ssl = 1
loo_Imap.Port = 993
li_Success = loo_Imap.Connect("imap.someMailServer.com")
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    return
end if

// Login
li_Success = loo_Imap.Login("****","****")
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    return
end if

// Select an IMAP mailbox
li_Success = loo_Imap.SelectMailbox("Inbox")
if li_Success <> 1 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    return
end if

// We can choose to fetch UIDs or sequence numbers.
li_FetchUids = 1
// Get the message IDs of all the emails in the mailbox
loo_MessageSet = loo_Imap.Search("ALL",li_FetchUids)
if loo_Imap.LastMethodSuccess = 0 then
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    return
end if

li_NumFound = loo_MessageSet.Count
if li_NumFound = 0 then
    Write-Debug "No messages found."
    destroy loo_MessageSet
    destroy loo_Imap
    return
end if

// Get the 1st 10 messages in messageSet.
li_UpperBound = 10
if li_NumFound < li_UpperBound then
    li_UpperBound = li_NumFound
end if

i = 0
li_BUid = loo_MessageSet.HasUids
do while i < li_UpperBound

    loo_Email = loo_Imap.FetchSingleHeader(loo_MessageSet.GetId(i),li_BUid)
    if loo_Imap.LastMethodSuccess = 0 then
        Write-Debug loo_Imap.LastErrorText
        destroy loo_MessageSet
        destroy loo_Imap
        return

    else
        // Do whatever is needed with the email.. 
        // ....

        destroy loo_Email
    end if

    i = i + 1
loop

// Alternatively, create a new message set containing the 1st 10 message id's (UID's) 
// from the search results message set:
loo_FirstTen = create oleobject
// Use "Chilkat_9_5_0.MessageSet" for versions of Chilkat < 10.0.0
li_rc = loo_FirstTen.ConnectToNewObject("Chilkat.MessageSet")

for i = 0 to li_UpperBound - 1
    loo_FirstTen.InsertId(loo_MessageSet.GetId(i))
next

destroy loo_MessageSet

// Download the 1st ten headers:

loo_Bundle = loo_Imap.FetchHeaders(loo_FirstTen)
if loo_Imap.LastMethodSuccess = 0 then
    destroy loo_FirstTen
    Write-Debug loo_Imap.LastErrorText
    destroy loo_Imap
    destroy loo_FirstTen
    return
end if

// Other examples show how to iterate over the emails contained within the bundle...

// Disconnect from the IMAP server.
li_Success = loo_Imap.Disconnect()

destroy loo_FirstTen
destroy loo_Bundle


destroy loo_Imap
destroy loo_FirstTen