ParentFolderIds

Article
03/29/2023

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="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

Share via