FindFolder

Artikel
03/29/2023

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

Siehe auch

FindFolder-Vorgang

Freigeben über