VB.NET

Fetch a POP3 Message's Raw MIME by UIDL

Demonstrates the Chilkat MailMan.FetchMimeBd method, which fetches an email from the POP3 server by UIDL and stores the raw MIME source bytes in a BinData. Chilkat clears the BinData before downloading. This example fetches one message's MIME into a BinData.

Background: Sometimes you want the message exactly as it arrived — the raw MIME bytes — rather than a parsed Email object, for example to archive it verbatim as a .eml file, forward it untouched, or hash it. Fetching into a BinData preserves every byte precisely, without any parsing or re-encoding that could alter the original.

Chilkat VB.NET Downloads

Download Chilkat for VB.NET

VB.NET

Dim success As Boolean = False

'  Demonstrates the MailMan.FetchMimeBd method, which fetches an email from the POP3 server
'  by UIDL and stores the raw MIME source bytes in a BinData.  Chilkat clears the BinData
'  before downloading.

Dim mailman As New Chilkat.MailMan

'  Configure the POP3 server connection.
mailman.MailHost = "pop.example.com"
mailman.MailPort = 995
mailman.PopSsl = True
mailman.PopUsername = "user@example.com"
mailman.PopPassword = "myPassword"

'  Fetch the raw MIME of a specific message by UIDL into a BinData.
Dim bdMime As New Chilkat.BinData

success = mailman.FetchMimeBd("0000000123abcdef",bdMime)
If (success = False) Then
    Debug.WriteLine(mailman.LastErrorText)
    Exit Sub
End If


Debug.WriteLine("MIME size (bytes) = " & bdMime.NumBytes)

'  Note: Explicitly connecting/authenticating is optional.  Chilkat MailMan automatically
'  connects and authenticates -- using the property settings above -- whenever a server
'  operation requires it.  Calling the explicit connect/authenticate methods can still be
'  helpful to determine whether a failure occurs while connecting or while authenticating.