FindFolder

Article
03/15/2022

L’élément FindFolder définit une demande de recherche de dossiers dans une boîte aux lettres.

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

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

FindFolderType

Attributs et éléments

Les sections suivantes décrivent les attributs, les éléments enfants et les éléments parents.

Attributs

Attribut	Description
Traversée	Définit le fonctionnement d’une recherche. Cet attribut est obligatoire.

Valeurs d’attribut traversal

Valeur	Description
Superficiel	Indique à l’opération FindFolder de rechercher uniquement le dossier identifié et de renvoyer uniquement les ID de dossier pour les éléments qui n’ont pas été supprimés. Il s’agit d’une traversée superficiel.
Deep	Indique à l’opération FindFolder de rechercher dans tous les dossiers enfants du dossier parent identifié et de renvoyer uniquement les ID de dossier pour les éléments qui n’ont pas été supprimés. C’est ce qu’on appelle une traversée profonde.
SoftDeleted	Indique à l’opération FindFolder d’effectuer une recherche de travers superficiel pour les éléments supprimés.

Éléments enfants

Élément	Description
FolderShape	Identifie les propriétés de dossier à inclure dans une réponse FindFolder.
IndexedPageFolderView	Décrit comment les informations d’élément pagué sont renvoyées dans une réponse FindFolder. Cet élément est facultatif.
FractionalPageFolderView	Décrit l’endroit où l’affichage pagaué démarre et le nombre maximal de dossiers renvoyés dans une demande FindFolder. Cet élément est facultatif.
Restriction	Définit une restriction ou une requête utilisée pour filtrer des dossiers dans une opération FindFolder. Cet élément est facultatif.
ParentFolderIds	Identifie les dossiers pour l’opération FindFolder à rechercher.

Éléments parents

Aucun.

Remarques

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel EWS de l'ordinateur qui exécute Microsoft Exchange Server 2007 sur lequel le rôle de serveur d'accès au client est installé.

Exemple

L’exemple suivant d’une requête FindFolder montre comment former une demande pour rechercher tous les dossiers situés dans une boîte de réception.

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

Informations sur l'élément

Élément	Exemple
Espace de noms	https://schemas.microsoft.com/exchange/services/2006/messages
Nom du schéma	Schéma Messages
Fichier de validation	Messages.xsd
Peut être vide	False

Voir aussi

Opération FindFolder