Outlook.com POP3: Download a Small Mailbox without Deleting Messages
See more POP3 Examples
Use OAuth2 and FetchAll(true,false,0,bundle) to download complete messages into an EmailBundle without issuing DELE. The example refuses a mailbox initially containing more than 25 messages. This count check is a demonstration guard, not a byte limit: individual messages can be large and new mail may arrive between commands. For large or changing mailboxes, fetch by string UIDL individually or in bounded batches.
POP does not expose folders or IMAP read/unread state. A later run can download the same messages again; persist processed UIDLs per account when needed. Downloading is not a delivery acknowledgement and does not mean another client will mark the mail read.
Personal Outlook.com: This includes Microsoft-hosted Outlook.com, Hotmail, and Live mailboxes. Use delegated OAuth2; ordinary passwords and app passwords are not a replacement for Modern Authentication. SMTP uses smtp-mail.outlook.com:587 with STARTTLS; incoming IMAP/POP use outlook.office365.com on ports 993/995 with implicit TLS. Enable POP or IMAP under Settings > Mail > Forwarding and IMAP before using that protocol. See current Outlook.com settings.
First authorize the account with https://outlook.office.com/POP.AccessAsUser.All and offline_access, then refresh the access token when needed. This example reads qa_data/tokens/hotmail.json from a private working directory. Microsoft Graph permissions such as Mail.Send or Mail.Read do not authorize these mail protocols. Do not print tokens or authentication logs.
Microsoft reference documentation
Chilkat Visual Basic 6.0 Downloads
Dim success As Long
success = 0
' Assumes Chilkat is unlocked. See Global Unlock Sample.
Dim token As New ChilkatJsonObject
success = token.LoadFile("qa_data/tokens/hotmail.json")
If (success <> 1) Then
Debug.Print "Could not read qa_data/tokens/hotmail.json from the private working directory."
Exit Sub
End If
If ((token.JsonTypeOf("access_token") <> 1) Or (token.StringOfEquals("access_token","",1) = 1)) Then
Debug.Print "An OAuth access token is required. Authorize or refresh the account first."
Exit Sub
End If
Dim mailbox As String
mailbox = "user@example.com"
Dim mailman As New ChilkatMailMan
mailman.MailHost = "outlook.office365.com"
mailman.MailPort = 995
mailman.PopSsl = 1
mailman.RequireSslCertVerify = 1
mailman.PopUsername = mailbox
mailman.PopPassword = ""
mailman.OAuth2AccessToken = token.StringOf("access_token")
success = mailman.Pop3Connect()
If (success <> 1) Then
Debug.Print "Could not establish the Microsoft POP3 TLS connection."
Exit Sub
End If
success = mailman.Pop3Authenticate()
If (success <> 1) Then
success = mailman.Pop3EndSessionNoQuit()
Debug.Print "POP3 authentication failed. Check the token, mailbox, POP setting, and account policy."
Exit Sub
End If
' FetchAll holds the mailbox contents in memory: only use it for a known small mailbox.
Dim count As Long
count = mailman.CheckMail()
If ((count < 0) Or (count > 25)) Then
success = mailman.Pop3EndSessionNoQuit()
Debug.Print "Could not count messages or the mailbox exceeds this example's 25-message limit."
Exit Sub
End If
Dim bundle As New ChilkatEmailBundle
' keepOnServer=true prevents DELE; headersOnly=false retrieves complete MIME messages.
success = mailman.FetchAll(1,0,0,bundle)
If (success <> 1) Then
success = mailman.Pop3EndSessionNoQuit()
Debug.Print "Could not download the messages."
Exit Sub
End If
' Check completeness as well as the method result. Another client can change the mailbox.
If (bundle.MessageCount < count) Then
success = mailman.Pop3EndSessionNoQuit()
Debug.Print "Downloaded fewer messages than the initial count. Check for retrieval errors or mailbox changes."
Exit Sub
End If
Dim email As New ChilkatEmail
Dim i As Long
i = 0
Do While (i < bundle.MessageCount)
success = bundle.EmailAt(i,email)
If (success <> 1) Then
success = mailman.Pop3EndSessionNoQuit()
Debug.Print "Could not read a downloaded message."
Exit Sub
End If
Debug.Print "Subject: " & email.Subject
i = i + 1
Loop
success = mailman.Pop3EndSession()
If (success <> 1) Then
Debug.Print "Messages were downloaded, but closing the POP session failed."
Exit Sub
End If
Debug.Print "Messages downloaded without deletion: " & bundle.MessageCount