Fetch Single Email by UID or Sequence Number

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

Download Chilkat IMAP ActiveX

LOCAL loImap
LOCAL lnSuccess
LOCAL loEmail
LOCAL lnUid
LOCAL lnIsUid
LOCAL j
LOCAL lnNumAttach
LOCAL lnAttachSize

loImap = CreateObject('Chilkat.Imap')

*  Anything unlocks the component and begins a fully-functional 30-day trial.
lnSuccess = loImap.UnlockComponent("Anything for 30-day trial")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loImap.LastErrorText)
    QUIT
ENDIF

*  Connect to an IMAP server.
lnSuccess = loImap.Connect("mail.chilkatsoft.com")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loImap.LastErrorText)
    QUIT
ENDIF

*  Login
lnSuccess = loImap.Login("***","***")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loImap.LastErrorText)
    QUIT
ENDIF

*  Select an IMAP mailbox
lnSuccess = loImap.SelectMailbox("Inbox")
IF (lnSuccess <> 1) THEN
    =MESSAGEBOX(loImap.LastErrorText)
    QUIT
ENDIF

lnUid = 2014

lnIsUid = 1

loEmail = loImap.FetchSingle(lnUid,lnIsUid)
IF (NOT (loEmail = NULL )) THEN

    *  Display the From and Subject
    ? loEmail.FromAddress
    ? loEmail.Subject

    *  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.
    ? "---- EMAIL BODY ----"
    ? loEmail.Body
    ? "--------------------"

    *  Display the recipients:

    FOR j = 0 TO loEmail.NumTo - 1
        ? loEmail.GetToName(j) + ", " + loEmail.GetToAddr(j)
    NEXT
    FOR j = 0 TO loEmail.NumCC - 1
        ? loEmail.GetCcName(j) + ", " + loEmail.GetCcAddr(j)
    NEXT

    *  Show the total size of the email, including body and attachments:
    ? loEmail.Size

    *  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:

    lnNumAttach = loImap.GetMailNumAttach(loEmail)
    ? STR(lnNumAttach)

    FOR j = 0 TO lnNumAttach - 1
        ? loImap.GetMailAttachFilename(loEmail,j)

        lnAttachSize = loImap.GetMailAttachSize(loEmail,j)
        ? "    size = " + STR(lnAttachSize) + " bytes"
    NEXT

    ? "--"
    RELEASE loEmail
ENDIF

*  Disconnect from the IMAP server.
loImap.Disconnect()