FindFolder

FindFolder 要素は、メールボックス内のフォルダーを検索する要求を定義します。

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

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

FindFolderType

属性と要素

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性	説明
トラバーサル	検索の実行方法を定義します。 この属性は必須です。

トラバーサル属性値

値	説明
浅い	特定されたフォルダーのみを検索し、削除されていないアイテムのフォルダー ID のみを返すように FindFolder 操作に指示します。 これは浅いトラバーサルと呼ばれます。
深い	特定された親フォルダーのすべての子フォルダーを検索し、削除されていないアイテムのフォルダー ID のみを返すように FindFolder 操作に指示します。 これはディープ トラバーサルと呼ばれます。
削除済み (回復可能)	削除された項目に対して浅いトラバーサル検索を実行するように FindFolder 操作に指示します。

子要素

Element	説明
FolderShape	FindFolder 応答に含めるフォルダー プロパティを識別します。
IndexedPageFolderView	FindFolder 応答でページングされたアイテム情報を返す方法について説明します。 この要素は省略できます。
FractionalPageFolderView	ページ ビューの開始場所と、FindFolder 要求で返されるフォルダーの最大数について説明します。 この要素は省略できます。
Restriction	FindFolder 操作でフォルダーをフィルター処理するために使用される制限またはクエリを定義します。 この要素は省略できます。
ParentFolderIds	検索する FindFolder 操作のフォルダーを識別します。

親要素

なし。

注釈

この要素を記述するスキーマは、クライアント アクセス サーバーの役割がインストールされている 2007 Microsoft Exchange Server実行されているコンピューターの EWS 仮想ディレクトリにあります。

例

次の FindFolder 要求の例は、受信トレイにあるすべてのフォルダーを検索する要求を形成する方法を示しています。

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

要素の情報

要素	例
Namespace	https://schemas.microsoft.com/exchange/services/2006/messages
スキーマ名	メッセージ スキーマ
検証ファイル	Messages.xsd
空に設定可能	False

関連項目

• FindFolder 操作