(Visual FoxPro) Fetch Single Email by UID or Sequence Number

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

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

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

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

* For versions of Chilkat < 10.0.0, use CreateObject('Chilkat_9_5_0.Imap')
loImap = CreateObject('Chilkat.Imap')

* Connect to an IMAP server.
* Use TLS
loImap.Ssl = 1
loImap.Port = 993
lnSuccess = loImap.Connect("imap.someMailServer.com")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    CANCEL
ENDIF

* Login
lnSuccess = loImap.Login("***","***")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    CANCEL
ENDIF

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

lnUid = 2014
lnIsUid = 1

loEmail = loImap.FetchSingle(lnUid,lnIsUid)
IF (loImap.LastMethodSuccess = 1) 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:
    ? STR(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.
lnSuccess = loImap.Disconnect()

RELEASE loImap