Edit

ParentFolderIds

  • Article

The ParentFolderIds element identifies folders for the FindItem and FindFolder operations to search.

<ParentFolderIds>
   <DistinguishedFolderId/>
<ParentFolderIds>

<ParentFolderIds>
   <FolderId/> 
<ParentFolderIds>

NonEmptyArrayOfBaseFolderIdsType

Attributes and elements

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

Attributes

None.

Child elements

Element Description
FolderId
Contains the identifier and change key of a folder. The ParentFolderIds element must use either this element or the DistinguishedFolderId element.
DistinguishedFolderId
Identifies Microsoft Exchange Server 2007 folders that can be referenced by name. The ParentFolderIds element must use either this element or the FolderId element.

Parent elements

Element Description
FindFolder
Defines a request to identify folders in a mailbox.
FindItem
Defines a request to find items in a mailbox.
ResolveNames
Defines a request to resolve ambiguous names.

Remarks

The ParentFolderIds element must use either the FolderId or the DistinguishedFolderId element. An unlimited number of folders can be defined for the search.

Example

<?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