ParentFolderIds

Topic Last Modified: 2008-06-27

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

Syntax

<ParentFolderIds>
   <DistinguishedFolderId/>
<ParentFolderIds>

<ParentFolderIds>
   <FolderId/>
<ParentFolderIds>

Type

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

Namespace

http://schemas.microsoft.com/exchange/services/2006/messages

Schema Name

Messages schema

Validation File

Messages.xsd

Can be Empty

False