Edit

FolderShape

  • Article

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="https://schemas.microsoft.com/exchange/services/2006/types">
  <soap:Body>
    <FindFolder Traversal="Shallow" xmlns="https://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
https://schemas.microsoft.com/exchange/services/2006/messages
Schema Name
Messages schema
Validation File
Messages.xsd
Can be Empty
False

See also

FindFolder