FolderShape
Last modified: October 13, 2012
Applies to: Exchange Online | Exchange Server 2007 | Exchange Server 2010 | Exchange Server 2013 | Office 365
The FolderShape element identifies the folder properties to include in a GetFolder, FindFolder, or SyncFolderHierarchy response.
<FolderShape> <BaseShape/> <AdditionalProperties/> </FolderShape>
FolderResponseShapeType
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child elements
|
Element |
Description |
|---|---|
|
Identifies the basic configuration of properties to return in a response. |
|
|
Identifies additional properties to return in a response. |
Parent elements
|
Element |
Description |
|---|---|
|
Defines a request to identify folders in a mailbox. The following is the XPath expression to this element: /FindFolder |
|
|
Defines a request to get a folder from the Exchange store. The following is the XPath expression to this element: /GetFolder |
|
|
Defines a request to synchronize a folder hierarchy on a client. The following is the XPath expression to this element: /SyncFolderHierarchy |
The FolderShape element is a required child element of the FindFolder element.
The schema that describes this element is located in the EWS virtual directory of the computer that is running MicrosoftExchange Server 2007 that has the Client Access server role installed.
The following example of a request demonstrates how to find all folders located in the first level of the Inbox folder.
<?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>