MailItem.MarkForDownload Property (Outlook)
Collapse the table of content
Expand the table of content
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

MailItem.MarkForDownload Property (Outlook)

Returns or sets an OlRemoteStatus constant that determines the status of an item once it is received by a remote user. Read/write.

expression .MarkForDownload

expression A variable that represents a MailItem object.

This property gives remote users with less-than-ideal data-transfer capabilities increased messaging flexibility.

The following example searches through the user's Inbox for items that have not yet been fully downloaded. If any items are found that are not fully downloaded, a message is displayed and the item is marked for download.

Sub DownloadItems() 
 Dim mpfInbox As Outlook.Folder 
 Dim obj As Object 
 Dim i As Integer 
 Set mpfInbox = Application.GetNamespace("MAPI").GetDefaultFolder(olFolderInbox) 
 'Loop all items in the Inbox folder 
 For i = 1 To mpfInbox.Items.Count 
 Set obj = mpfInbox.Items.Item(i) 
 'Verify if the state of the item is olHeaderOnly 
 If obj.DownloadState = olHeaderOnly Then 
 MsgBox ("This item has not been fully downloaded.") 
 'Mark the item to be downloaded. 
 obj.MarkForDownload = olMarkedForDownload 
 End If 
End Sub
© 2016 Microsoft