(DataFlex) 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

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoImap
    Boolean iSuccess
    Variant vMessageSet
    Handle hoMessageSet
    Boolean iFetchUids
    Integer iNumFound
    Integer iUpperBound
    Integer i
    Boolean iBUid
    Variant vEmail
    Handle hoEmail
    Variant vFirstTen
    Handle hoFirstTen
    Variant vBundle
    Handle hoBundle
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

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

    Get Create (RefClass(cComChilkatImap)) To hoImap
    If (Not(IsComObjectCreated(hoImap))) Begin
        Send CreateComObject of hoImap
    End

    // Connect to an IMAP server.
    // Use TLS
    Set ComSsl Of hoImap To True
    Set ComPort Of hoImap To 993
    Get ComConnect Of hoImap "imap.someMailServer.com" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Login
    Get ComLogin Of hoImap "****" "****" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Select an IMAP mailbox
    Get ComSelectMailbox Of hoImap "Inbox" To iSuccess
    If (iSuccess <> True) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // We can choose to fetch UIDs or sequence numbers.
    Move True To iFetchUids
    // Get the message IDs of all the emails in the mailbox
    Get ComSearch Of hoImap "ALL" iFetchUids To vMessageSet
    If (IsComObject(vMessageSet)) Begin
        Get Create (RefClass(cComChilkatMessageSet)) To hoMessageSet
        Set pvComObject Of hoMessageSet To vMessageSet
    End
    Get ComLastMethodSuccess Of hoImap To bTemp1
    If (bTemp1 = False) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get ComCount Of hoMessageSet To iNumFound
    If (iNumFound = 0) Begin
        Showln "No messages found."
        Send Destroy of hoMessageSet
        Procedure_Return
    End

    // Get the 1st 10 messages in messageSet.
    Move 10 To iUpperBound
    If (iNumFound < iUpperBound) Begin
        Move iNumFound To iUpperBound
    End

    Move 0 To i
    Get ComHasUids Of hoMessageSet To iBUid
    While (i < iUpperBound)

        Get ComGetId Of hoMessageSet i To iTemp1
        Get ComFetchSingleHeader Of hoImap iTemp1 iBUid To vEmail
        If (IsComObject(vEmail)) Begin
            Get Create (RefClass(cComChilkatEmail)) To hoEmail
            Set pvComObject Of hoEmail To vEmail
        End
        Get ComLastMethodSuccess Of hoImap To bTemp1
        If (bTemp1 = False) Begin
            Get ComLastErrorText Of hoImap To sTemp1
            Showln sTemp1
            Send Destroy of hoMessageSet
            Procedure_Return

        End
        Else Begin
            // Do whatever is needed with the email.. 
            // ....

            Send Destroy of hoEmail
        End

        Move (i + 1) To i
    Loop

    // Alternatively, create a new message set containing the 1st 10 message id's (UID's) 
    // from the search results message set:
    Get Create (RefClass(cComChilkatMessageSet)) To hoFirstTen
    If (Not(IsComObjectCreated(hoFirstTen))) Begin
        Send CreateComObject of hoFirstTen
    End

    For i From 0 To (iUpperBound - 1)
        Get ComGetId Of hoMessageSet i To iTemp1
        Send ComInsertId To hoFirstTen iTemp1
    Loop

    Send Destroy of hoMessageSet

    // Download the 1st ten headers:

    Get pvComObject of hoFirstTen to vFirstTen
    Get ComFetchHeaders Of hoImap vFirstTen To vBundle
    If (IsComObject(vBundle)) Begin
        Get Create (RefClass(cComChilkatEmailBundle)) To hoBundle
        Set pvComObject Of hoBundle To vBundle
    End
    Get ComLastMethodSuccess Of hoImap To bTemp1
    If (bTemp1 = False) Begin
        Send Destroy of hoFirstTen
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

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

    // Disconnect from the IMAP server.
    Get ComDisconnect Of hoImap To iSuccess

    Send Destroy of hoFirstTen
    Send Destroy of hoBundle


End_Procedure