Sample code for 30+ languages & platforms
Visual FoxPro Requires Chilkat v11.0.0+

Find an email by subject and fetch it by IMAP UID

See more Email Object Examples

Search the selected INBOX by subject and fetch the first matching UID into an Email. The example requests complete attachment bodies and uses peek mode to preserve the read flag. Configure your own IMAP TLS endpoint and credentials.

Chilkat Visual FoxPro Downloads

Visual FoxPro
LOCAL lnSuccess
LOCAL loImap
LOCAL loMatches
LOCAL lnUid
LOCAL loEmail

lnSuccess = 0

*  Assumes Chilkat is unlocked. See Global Unlock Sample.

loImap = CreateObject('Chilkat.Imap')
loImap.Ssl = 1
loImap.Port = 993
loImap.RequireSslCertVerify = 1
loImap.PeekMode = 1
loImap.AutoDownloadAttachments = 1
lnSuccess = loImap.Connect("imap.example.com")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    CANCEL
ENDIF

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

lnSuccess = loImap.SelectMailbox("INBOX")
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    CANCEL
ENDIF

loMatches = CreateObject('Chilkat.MessageSet')
lnSuccess = loImap.QueryMbx('SUBJECT "Sample message"',1,loMatches)
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    RELEASE loMatches
    CANCEL
ENDIF

IF (loMatches.Count = 0) THEN
    ? "No matching message in INBOX."
    lnSuccess = loImap.Disconnect()
    IF (lnSuccess <> 1) THEN
        ? loImap.LastErrorText
        RELEASE loImap
        RELEASE loMatches
        CANCEL
    ENDIF

    RELEASE loImap
    RELEASE loMatches
    CANCEL
ENDIF

*  The search returned UIDs. Use the same identifier type for the fetch.
lnUid = loMatches.GetId(0)
loEmail = CreateObject('Chilkat.Email')
lnSuccess = loImap.FetchEmail(0,lnUid,1,loEmail)
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    RELEASE loMatches
    RELEASE loEmail
    CANCEL
ENDIF

? "Mailbox INBOX, UIDVALIDITY " + STR(loImap.UidValidity) + ", UID " + STR(lnUid)
lnSuccess = loImap.Disconnect()
IF (lnSuccess <> 1) THEN
    ? loImap.LastErrorText
    RELEASE loImap
    RELEASE loMatches
    RELEASE loEmail
    CANCEL
ENDIF

*  The downloaded Email remains usable after disconnecting.
? "Subject: " + loEmail.Subject + "  Files: " + STR(loEmail.NumAttachments)

lnSuccess = loEmail.SaveEml("imap-received.eml")
IF (lnSuccess <> 1) THEN
    ? loEmail.LastErrorText
    RELEASE loImap
    RELEASE loMatches
    RELEASE loEmail
    CANCEL
ENDIF

? "Saved imap-received.eml."

RELEASE loImap
RELEASE loMatches
RELEASE loEmail