FindConversation

Article
03/29/2023

The FindConversation element defines a request to find conversations in a mailbox.

<FindConversation Traversal="" ViewFilter="">
   <IndexedPageItemView/>
   <SeekToConditionPageItemView/>
   <SortOrder/>
   <ParentFolderId/>
   <MailboxScope/>
   <QueryString/>
   <ConversationShape/>
</FindConversation>

FindConversationType

Attributes and elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute	Description
Traversal	Identifies the types of sub-tree traversal. This attribute is optional.
ViewFilter	Identifies the types view filters. This attribute is optional.

Traversal attribute values

Value	Description
Shallow	Indicates a shallow traversal.
Deep	Indicates a deep traversal.

ViewFilter attribute values

Value	Description
All	Find all conversations.
Flagged	Find flagged conversations.
HasAttachment	Find conversations with attachments.
ToOrCcMe	Find conversations addressed or cc'd to me.
Unread	Find unread conversations.
TaskActive	Find active tasks.
TaskOverdue	Find overdue tasks.
TaskCompleted	Find completed tasks.
NoClutter	For internal use only.
Clutter	For internal use only.

Child elements

Element	Description
IndexedPageItemView	Describes how paged conversation information is returned.
SeekToConditionPageItemView	Specifies the condition that is used to identify the end of a search, the starting index of a search, the maximum entries to return, and the search directions for a FindItem or FindConversation search.
SortOrder	Defines how items are sorted in a FindConversation operation request. The conversation:LastDeliveryTime property is the only property that is supported for sorting when the FindConversation operation is used.
ParentFolderId (TargetFolderIdType)	Identifies the folder to search for conversations.
MailboxScope	Specifies whether a search or fetch for a conversation should span either the primary mailbox, archive mailbox, or both the primary and archive mailbox.
QueryString (QueryStringType)	Specifies a mailbox query string based on Advanced Query Syntax (AQS).
ConversationShape	Identifies the property set to return in a FindConversation operation response.

Parent elements

None.

Remarks

The schema that describes this element is located in the IIS virtual directory that hosts Exchange Web Services.This element was introduced in Exchange Server 2010 Service Pack 1 (SP1).

Element information

Element	Example
Namespace	https://schemas.microsoft.com/exchange/services/2006/messages
Schema Name	Messages schema
Validation File	Messages.xsd
Can be Empty	False