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="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>
要素の情報
要素 | 例 |
---|---|
Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
スキーマ名 |
メッセージ スキーマ |
検証ファイル |
Messages.xsd |
空に設定可能 |
False |