FolderShape
The FolderShape element identifies the folder properties to include in a GetFolder, FindFolder, or SyncFolderHierarchy response.
<FolderShape>
<BaseShape/>
<AdditionalProperties/>
</FolderShape>
FolderResponseShapeType
Attributes and elements
The following sections describe attributes, child elements, and parent elements.
Attributes
None.
Child elements
Element | Description |
---|---|
BaseShape |
Identifies the basic configuration of properties to return in a response. |
AdditionalProperties |
Identifies additional properties to return in a response. |
Parent elements
Element | Description |
---|---|
FindFolder |
Defines a request to identify folders in a mailbox. The following is the XPath expression to this element: /FindFolder |
GetFolder |
Defines a request to get a folder from the Exchange store. The following is the XPath expression to this element: /GetFolder |
SyncFolderHierarchy |
Defines a request to synchronize a folder hierarchy on a client. The following is the XPath expression to this element: /SyncFolderHierarchy |
Remarks
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.
Example
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>
Element information
Element | Example |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
Schema Name |
Messages schema |
Validation File |
Messages.xsd |
Can be Empty |
False |