(DataFlex) Fetch Single Email by UID or Sequence Number

Assuming the UID is known, download a single email by UID from an IMAP mail server.

Note: This example requires Chilkat v11.0.0 or greater.

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

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoImap
    Variant vEmail
    Handle hoEmail
    Integer iUid
    Boolean iIsUid
    Integer j
    Integer iNumAttach
    Integer iAttachSize
    String sTemp1
    String sTemp2
    Integer iTemp1

    Move False To iSuccess

    // This example requires 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.example.com" To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Login
    Get ComLogin Of hoImap "***" "***" To iSuccess
    If (iSuccess = False) 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 = False) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatEmail)) To hoEmail
    If (Not(IsComObjectCreated(hoEmail))) Begin
        Send CreateComObject of hoEmail
    End

    Move 2014 To iUid
    Move True To iIsUid

    Get pvComObject of hoEmail to vEmail
    Get ComFetchEmail Of hoImap False iUid iIsUid vEmail To iSuccess
    If (iSuccess = False) Begin
        Get ComLastErrorText Of hoImap To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // Display the From and Subject
    Get ComFromAddress Of hoEmail To sTemp1
    Showln sTemp1
    Get ComSubject Of hoEmail To sTemp1
    Showln sTemp1

    // Display the Body property, which is the default body.
    // If an email has an HTML body, the Body property contains
    // the HTML source.  Otherwise it contains the plain-text
    // body.
    Showln "---- EMAIL BODY ----"
    Get ComBody Of hoEmail To sTemp1
    Showln sTemp1
    Showln "--------------------"

    // Display the recipients:

    Get ComNumTo Of hoEmail To iTemp1
    For j From 0 To (iTemp1 - 1)
        Get ComGetToName Of hoEmail j To sTemp1
        Get ComGetToAddr Of hoEmail j To sTemp2
        Showln sTemp1 ", " sTemp2
    Loop

    Get ComNumCC Of hoEmail To iTemp1
    For j From 0 To (iTemp1 - 1)
        Get ComGetCcName Of hoEmail j To sTemp1
        Get ComGetCcAddr Of hoEmail j To sTemp2
        Showln sTemp1 ", " sTemp2
    Loop

    // Show the total size of the email, including body and attachments:
    Get ComSize Of hoEmail To iTemp1
    Showln iTemp1

    // When a full email is downloaded, we would use the
    // email.NumAttachments property in conjunction with the
    // email.GetMailAttach* methods.
    // However, when an email object contains only the header,
    // we need to access the attachment info differently:
    Get pvComObject of hoEmail to vEmail
    Get ComGetMailNumAttach Of hoImap vEmail To iNumAttach
    Showln iNumAttach

    For j From 0 To (iNumAttach - 1)
        Get ComGetMailAttachFilename Of hoImap         Get pvComObject of hoEmail to vEmail
vEmail j To sTemp1
        Showln sTemp1
        Get pvComObject of hoEmail to vEmail
        Get ComGetMailAttachSize Of hoImap vEmail j To iAttachSize
        Showln "    size = " iAttachSize " bytes"
    Loop

    Showln "--"

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


End_Procedure