(Lianja) 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 Lianja Extension Download Chilkat Lianja Extension

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

loImap = createobject("CkImap")

// Connect to an IMAP server.
// Use TLS
loImap.Ssl = .T.
loImap.Port = 993
llSuccess = loImap.Connect("imap.someMailServer.com")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    return
endif

// Login
llSuccess = loImap.Login("****","****")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    return
endif

// Select an IMAP mailbox
llSuccess = loImap.SelectMailbox("Inbox")
if (llSuccess <> .T.) then
    ? loImap.LastErrorText
    release loImap
    return
endif

// We can choose to fetch UIDs or sequence numbers.
llFetchUids = .T.
// Get the message IDs of all the emails in the mailbox
loMessageSet = loImap.Search("ALL",llFetchUids)
if (loImap.LastMethodSuccess = .F.) then
    ? loImap.LastErrorText
    release loImap
    return
endif

lnNumFound = loMessageSet.Count
if (lnNumFound = 0) then
    ? "No messages found."
    release loMessageSet
    release loImap
    return
endif

// Get the 1st 10 messages in messageSet.
lnUpperBound = 10
if (lnNumFound < lnUpperBound) then
    lnUpperBound = lnNumFound
endif

i = 0
llBUid = loMessageSet.HasUids
do while i < lnUpperBound

    loEmail = loImap.FetchSingleHeader(loMessageSet.GetId(i),llBUid)
    if (loImap.LastMethodSuccess = .F.) then
        ? loImap.LastErrorText
        release loMessageSet
        release loImap
        return

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

        release loEmail
    endif

    i = i + 1
enddo

// Alternatively, create a new message set containing the 1st 10 message id's (UID's) 
// from the search results message set:
loFirstTen = createobject("CkMessageSet")

for i = 0 to lnUpperBound - 1
    loFirstTen.InsertId(loMessageSet.GetId(i))
next

release loMessageSet

// Download the 1st ten headers:

loBundle = loImap.FetchHeaders(loFirstTen)
if (loImap.LastMethodSuccess = .F.) then
    release loFirstTen
    ? loImap.LastErrorText
    release loImap
    release loFirstTen
    return
endif

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

// Disconnect from the IMAP server.
llSuccess = loImap.Disconnect()

release loFirstTen
release loBundle


release loImap
release loFirstTen