Visual Basic 6.0

Fetch Full Email Given Email Header

When you fetch email headers using UIDs instead of sequence numbers, the email object (which includes only the header) will have auto-generated ckx-imap-* headers. These headers provide details like the UID and attachments. The IMAP UID is found in the ckx-imap-uid header. Additionally, the ckx-imap-isUid header indicates whether the email header was downloaded by UID, showing YES or NO. Since sequence numbers can change if emails are deleted, UIDs are essential for downloading the correct full email.

The Chilkat Email object offers a GetImapUid method to retrieve the UID from the ckx-imap-uid header. This UID can be used to fetch the full email.

Visual Basic 6.0

Dim success As Long
success = 0

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

Dim imap As New ChilkatImap

' Connect to an IMAP server.
' Use TLS
imap.Ssl = 1
imap.Port = 993
success = imap.Connect("imap.example.com")
If (success = 0) Then
    Debug.Print imap.LastErrorText
    Exit Sub
End If

' Login
success = imap.Login("***","***")
If (success = 0) Then
    Debug.Print imap.LastErrorText
    Exit Sub
End If

' Select an IMAP mailbox
success = imap.SelectMailbox("Inbox")
If (success = 0) Then
    Debug.Print imap.LastErrorText
    Exit Sub
End If

Dim emailHeader As New ChilkatEmail
Dim emailFull As New ChilkatEmail

Dim uid As Long
uid = 2014
Dim isUid As Long
isUid = 1

' Fetch only the email header
success = imap.FetchEmail(1,uid,isUid,emailHeader)
If (success = 0) Then
    Debug.Print imap.LastErrorText
    Exit Sub
End If

' Now fetch the full email
Dim uidFromCkxHeader As Long
uidFromCkxHeader = emailHeader.GetImapUid()
If (uidFromCkxHeader < 0) Then
    ' Failed. 
    Debug.Print "No ckx-imap-uid header was found."
    Exit Sub
End If

success = imap.FetchEmail(0,uid,isUid,emailFull)
If (success = 0) Then
    Debug.Print imap.LastErrorText
    Exit Sub
End If

' OK, we have the full email, do whatever we want...

' Disconnect from the IMAP server.
success = imap.Disconnect()