(Visual FoxPro) Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

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

LOCAL loImap
LOCAL lnSuccess
LOCAL loMessageSet
LOCAL lnFetchUids
LOCAL loBundle
LOCAL i
LOCAL loEmail
LOCAL j
LOCAL lcName
LOCAL lcAddr
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

* We can choose to fetch UIDs or sequence numbers.
lnFetchUids = 1
* Get the message IDs of all the emails in the mailbox
loMessageSet = loImap.Search("ALL",lnFetchUids)
IF (loImap.LastMethodSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    CANCEL
ENDIF

* When downloading headers, each email object contains
* (obviously) the headers, but the body will be missing.
* Also, attachments will not be included.  However, it is
* possible to get information about the attachments
* as well as the complete size of the email.

loBundle = loImap.FetchHeaders(loMessageSet)
IF (loImap.LastMethodSuccess <> 1) THEN
    RELEASE loMessageSet
    ? loImap.LastErrorText
    RELEASE loImap
    CANCEL
ENDIF

* Loop over the email objects and display information
* about each:

FOR i = 0 TO loBundle.MessageCount - 1

    loEmail = loBundle.GetEmail(i)

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

    * Display the recipients:

    FOR j = 0 TO loEmail.NumTo - 1
        lcName = loEmail.GetToName(j)
        lcAddr = loEmail.GetToAddr(j)
        ? lcName + ", " + lcAddr
    NEXT
    FOR j = 0 TO loEmail.NumCC - 1
        lcName = loEmail.GetCcName(j)
        lcAddr = loEmail.GetCcAddr(j)
        ? lcName + ", " + lcAddr
    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)
    FOR j = 0 TO lnNumAttach - 1
        ? loImap.GetMailAttachFilename(loEmail,j)
        lnAttachSize = loImap.GetMailAttachSize(loEmail,j)
        ? "    size = " + STR(lnAttachSize) + " bytes"
    NEXT

    ? "--"
    RELEASE loEmail
NEXT

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

RELEASE loMessageSet
RELEASE loBundle

RELEASE loImap