FindFolder
Das FindFolder-Element definiert eine Anforderung zum Suchen von Ordnern in einem Postfach.
<FindFolder Traversal="Shallow/Deep/SoftDeleted">
<FolderShape/>
<IndexedPageFolderView/>
<Restriction/>
<ParentFolderIds/>
</FindFolder>
<FindFolder Traversal="Shallow/Deep/SoftDeleted">
<FolderShape/>
<FractionalPageFolderView/>
<Restriction/>
<ParentFolderIds/>
</FindFolder>
FindFolderType
Attribute und Elemente
In den folgenden Abschnitten werden Attribute, untergeordnete und übergeordnete Elemente erläutert.
Attribute
| Attribut | Beschreibung |
|---|---|
| Traversal |
Definiert, wie eine Suche ausgeführt wird. Dieses Attribut ist erforderlich. |
Traversal-Attributwerte
| Wert | Beschreibung |
|---|---|
| Flachen |
Weist den FindFolder-Vorgang an, nur den identifizierten Ordner zu durchsuchen und nur die Ordner-IDs für Elemente zurückzugeben, die nicht gelöscht wurden. Dies wird als flacher Durchlauf bezeichnet. |
| Tief |
Weist den FindFolder-Vorgang an, alle untergeordneten Ordner des identifizierten übergeordneten Ordners zu durchsuchen und nur die Ordner-IDs für Elemente zurückzugeben, die nicht gelöscht wurden. Dies wird als deep traversal bezeichnet. |
| SoftDeleted |
Weist den FindFolder-Vorgang an, eine flache Durchlaufsuche nach gelöschten Elementen durchzuführen. |
Untergeordnete Elemente
| Element | Beschreibung |
|---|---|
| FolderShape |
Identifiziert die Ordnereigenschaften, die in eine FindFolder-Antwort eingeschlossen werden sollen. |
| IndexedPageFolderView |
Beschreibt, wie ausgelagerte Elementinformationen in einer FindFolder-Antwort zurückgegeben werden. Dieses Element ist optional. |
| FractionalPageFolderView |
Beschreibt, wo die seitenseitige Ansicht beginnt und wie viele Ordner in einer FindFolder-Anforderung maximal zurückgegeben werden. Dieses Element ist optional. |
| Restriction |
Definiert eine Einschränkung oder Abfrage, die zum Filtern von Ordnern in einem FindFolder-Vorgang verwendet wird. Dieses Element ist optional. |
| ParentFolderIds |
Identifiziert Ordner für den zu durchsuchenden FindFolder-Vorgang. |
Übergeordnete Elemente
Keine.
HinwBemerkungeneise
Das Schema, das dieses Element beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, der Microsoft Exchange Server 2007 mit installierter Clientzugriff-Serverrolle ausführt.
Beispiel
Das folgende Beispiel einer FindFolder-Anforderung zeigt, wie eine Anforderung zum Suchen aller Ordner in einem Posteingang erstellt wird.
<?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>
Informationen zu Elementen
| Element | Beispiel |
|---|---|
| Namespace |
http://schemas.microsoft.com/exchange/services/2006/messages |
| Name des Schemas |
Nachrichtenschema |
| Überprüfungsdatei |
Messages.xsd |
| Leer kann sein |
False |