Partager via


FindFolder

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