FindFolder
Last modified: October 13, 2012
Applies to: Exchange Online | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013 | Office 365
The FindFolder element defines a request to find folders in a mailbox.
<FindFolder Traversal="Shallow/Deep/SoftDeleted"> <FolderShape/> <IndexedPageFolderView/> <Restriction/> <ParentFolderIds/> </FindFolder>
<FindFolder Traversal="Shallow/Deep/SoftDeleted"> <FolderShape/> <FractionalPageFolderView/> <Restriction/> <ParentFolderIds/> </FindFolder>
FindFolderType
The following sections describe attributes, child elements, and parent elements.
Attributes
|
Attribute |
Description |
|---|---|
|
Traversal |
Defines how a search is performed. This attribute is required. |
Traversal Attribute Values
|
Value |
Description |
|---|---|
|
Shallow |
Instructs the FindFolder operation to search only the identified folder and to return only the folder IDs for items that have not been deleted. This is called a shallow traversal. |
|
Deep |
Instructs the FindFolder operation to search in all child folders of the identified parent folder and to return only the folder IDs for items that have not been deleted. This is called a deep traversal. |
|
SoftDeleted |
Instructs the FindFolder operation to perform a shallow traversal search for deleted items. |
Child elements
|
Element |
Description |
|---|---|
|
Identifies the folder properties to include in a FindFolder response. |
|
|
Describes how paged item information is returned in a FindFolder response. This element is optional. |
|
|
Describes where the paged view starts and the maximum number of folders returned in a FindFolder request. This element is optional. |
|
|
Defines a restriction or query that is used to filter folders in a FindFolder operation. This element is optional. |
|
|
Identifies folders for the FindFolder operation to search. |
Parent elements
None.
The following example of a FindFolder request shows how to form a request to find all the folders located in an Inbox.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<FindFolder Traversal="Shallow" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<FolderShape>
<t:BaseShape>Default</t:BaseShape>
</FolderShape>
<ParentFolderIds>
<t:DistinguishedFolderId Id="inbox"/>
</ParentFolderIds>
</FindFolder>
</soap:Body>
</soap:Envelope>