Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
SetAlwaysMoveToFolder Method

Conversation.SetAlwaysMoveToFolder Method (Outlook)

Sets a Folder object that indicates the folder to which all existing conversation items and new items that arrive in the conversation are always moved.

Version Added: Outlook 2010

expression .SetAlwaysMoveToFolder(MoveToFolder, Store)

expression A variable that represents a Conversation object.

Parameters

Name

Required/Optional

Data Type

Description

MoveToFolder

Required

Folder

Specifies the folder to which all existing items and new items that arrive in the conversation are always moved.

Store

Required

Store

Specifies the store that contains the folder to which items of the conversation are moved.

The SetAlwaysMoveToFolder method operates on conversation items in the delivery store specified by the Store parameter. If the Store parameter represents a non-delivery store such as an archive .pst store, the move action will apply to conversation items in the default delivery store.

If the MoveToFolder parameter specifies an invalid folder that does not exist, has been moved, or is read-only, Outlook will raise an error.

To stop the always-move-to-folder action for conversations items in a store, call the StopAlwaysMoveToFolder method.

Note Note

Setting the Deleted Items folder as the MoveToFolder parameter in SetAlwaysMoveToFolder is not equivalent to calling SetAlwaysDelete on the same store and conversation. Setting the MoveToFolder parameter to the Deleted Items folder results in the GetAlwaysDelete method returning the value olDoNotDelete.

The BeforeItemMove event of the Folder object occurs when you call SetAlwaysMoveToFolder.

The following Visual Basic for Applications (VBA) example shows how to set the folder to which existing conversation items and new items that arrive in the conversation of a specific mail item are always moved. The code example, DemoSetAlwaysMoveToFolder, chooses the first mail item displayed in the Reading Pane as the specific mail item, and the folder named "1-Reference" under the Inbox folder as the folder to move the conversation items to. DemoSetAlwaysMoveToFolder verifies that conversations are enabled in the store for the selected mail item, obtains the conversation object for that mail item if a conversation exists, and uses SetAlwaysMoveToFolder to always move all existing conversation items and new items that arrive in the conversation to the specified folder.

Sub DemoSetAlwaysMoveToFolder() 
 Dim oMail As Outlook.MailItem 
 Dim oConv As Outlook.Conversation 
 Dim oStore As Outlook.Store 
 Dim oFolder As Outlook.Folder 
 
 ' Obtain a reference to the folder where conversation items will be moved. 
 Set oFolder = _ 
 Application.Session.GetDefaultFolder(olFolderInbox).Folders("1-Reference") 
 ' Get the Item displayed in the Reading Pane. 
 Set oMail = ActiveExplorer.Selection(1) 
 Set oStore = oFolder.Store 
 If oStore.IsConversationEnabled Then 
 Set oConv = oMail.GetConversation 
 If Not (oConv Is Nothing) Then 
 oConv.SetAlwaysMoveToFolder oFolder, oStore 
 End If 
 End If 
End Sub
Show:
© 2015 Microsoft