FindFolderFindFolder

Findfolder要素は、メールボックス内のフォルダーを検索する要求を定義します。The FindFolder element defines a request to find folders in a mailbox.

<FindFolder Traversal="Shallow/Deep/SoftDeleted">
   <FolderShape/>
   <IndexedPageFolderView/>
   <Restriction/>
   <ParentFolderIds/>
</FindFolder>
<FindFolder Traversal="Shallow/Deep/SoftDeleted">
   <FolderShape/>
   <FractionalPageFolderView/>
   <Restriction/>
   <ParentFolderIds/>
</FindFolder>

FindFolderTypeFindFolderType

属性と要素Attributes and elements

以下のセクションで、属性、子要素、親要素について説明します。The following sections describe attributes, child elements, and parent elements.

属性Attributes

属性Attribute 説明Description
走査Traversal
検索の実行方法を定義します。Defines how a search is performed. この属性は必須です。This attribute is required.

トラバース属性値Traversal attribute values

Value 説明Description
浅いShallow
FindFolder 操作に対して、識別されたフォルダーのみを検索し、削除されていないアイテムのフォルダー Id のみを返すように指示します。Instructs the FindFolder operation to search only the identified folder and to return only the folder IDs for items that have not been deleted. これは、浅い走査と呼ばれます。This is called a shallow traversal.
深いDeep
FindFolder 操作に対して、識別された親フォルダーのすべての子フォルダーを検索し、削除されていないアイテムのフォルダー Id のみを返すように指示します。Instructs the FindFolder operation to search in all child folders of the identified parent folder and to return only the folder IDs for items that have not been deleted. これは deep トラバースと呼ばれます。This is called a deep traversal.
削除済み (回復可能)SoftDeleted
FindFolder 操作に対して、削除されたアイテムに対して緩斜面検索を実行するように指示します。Instructs the FindFolder operation to perform a shallow traversal search for deleted items.

子要素Child elements

ElementElement 説明Description
FolderShapeFolderShape
FindFolder 応答に含めるフォルダーのプロパティを識別します。Identifies the folder properties to include in a FindFolder response.
IndexedPageFolderViewIndexedPageFolderView
ページアイテムの情報が FindFolder 応答で返される方法について説明します。Describes how paged item information is returned in a FindFolder response. この要素は省略できます。This element is optional.
FractionalPageFolderViewFractionalPageFolderView
ページビューの開始位置と、FindFolder 要求で返されるフォルダーの最大数を指定します。Describes where the paged view starts and the maximum number of folders returned in a FindFolder request. この要素は省略できます。This element is optional.
制限Restriction
FindFolder 操作でフォルダーにフィルターを適用するために使用される制限またはクエリを定義します。Defines a restriction or query that is used to filter folders in a FindFolder operation. この要素は省略できます。This element is optional.
ParentFolderIdsParentFolderIds
検索する FindFolder 操作のフォルダーを識別します。Identifies folders for the FindFolder operation to search.

親要素Parent elements

なし。None.

注釈Remarks

この要素を記述するスキーマは、Microsoft Exchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあり、クライアントアクセスサーバーの役割がインストールされています。The schema that describes this element is located in the EWS virtual directory of the computer that is running Microsoft Exchange Server 2007 that has the Client Access server role installed.

Example

FindFolder 要求の次の例は、受信トレイ内のすべてのフォルダーを検索するための要求を形成する方法を示しています。The following example of a FindFolder request shows how to form a request to find all the folders located in an Inbox.

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

NamespaceNamespace
https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名Schema Name
メッセージスキーマMessages schema
検証ファイルValidation File
メッセージ .xsdMessages.xsd
空に設定可能Can be Empty
正しくないFalse

関連項目See also