Opération GetFolder

  • Article

L’opération GetFolder obtient des dossiers à partir du magasin Exchange.

Exemple de requête GetFolder

Description

L’exemple suivant de requête GetFolder montre comment obtenir un identificateur de dossier, un nom complet, le nombre d’éléments dans ce dossier, le nombre de dossiers enfants et le nombre d’éléments non lus dans le dossier.

Code

<?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>
    <GetFolder xmlns="https://schemas.microsoft.com/exchange/services/2006/messages"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
      <FolderShape>
        <t:BaseShape>Default</t:BaseShape>
      </FolderShape>
      <FolderIds>
        <t:DistinguishedFolderId Id="inbox"/>
      </FolderIds>
    </GetFolder>
  </soap:Body>
</soap:Envelope>

Éléments de requête

Cette requête GetFolder comprend les éléments suivants :

Consultez le schéma pour obtenir des éléments supplémentaires que vous pouvez utiliser pour former une requête GetFolder .

Remarque

Le schéma qui décrit cet élément se trouve dans le répertoire virtuel IIS qui héberge les services web Exchange.

Exemple de réponse GetFolder

Description

L’exemple de corps SOAP (Simple Object Access Protocol) suivant montre une réponse réussie à la requête GetFolder .

Remarque

L’ID de dossier et la clé de modification ont été raccourcis pour préserver la lisibilité.

Code

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                       xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                       xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:GetFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:Folders>
            <t:Folder>
              <t:FolderId Id="AQApA=" ChangeKey="AQAAAB" />
              <t:DisplayName>Inbox</t:DisplayName>
              <t:TotalCount>2</t:TotalCount>
              <t:ChildFolderCount>0</t:ChildFolderCount>
              <t:UnreadCount>2</t:UnreadCount>
            </t:Folder>
          </m:Folders>
        </m:GetFolderResponseMessage>
      </m:ResponseMessages>
    </GetFolderResponse>
  </soap:Body>
</soap:Envelope>

Éléments de réponse

Cette réponse GetFolder comprend les éléments suivants :

Exemple de réponse d’erreur GetFolder

Description

L’exemple de corps SOAP suivant montre une réponse d’erreur provoquée par un FolderId incorrect dans la requête.

Code

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" 
               xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Header>
    <t:ServerVersionInfo MajorVersion="8" MinorVersion="0" MajorBuildNumber="628" MinorBuildNumber="0" 
                         xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetFolderResponse xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
                       xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types" 
                       xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:GetFolderResponseMessage ResponseClass="Error">
          <m:MessageText>Id is malformed.</m:MessageText>
          <m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
          <m:Folders />
        </m:GetFolderResponseMessage>
      </m:ResponseMessages>
    </GetFolderResponse>
  </soap:Body>
</soap:Envelope>

Éléments de réponse

Cette réponse d’erreur GetFolder inclut les éléments suivants :

Différences entre les versions

Pour les applications qui ciblent Exchange Online, Exchange Online dans le cadre de Office 365 ou une version locale d’Exchange à compter d’Exchange 2013, les autorisations de dossier ne sont pas retournées lorsque l’élément BaseShape a une valeur AllProperties dans la demande d’opération GetFolder. Pour récupérer les autorisations de dossier, ajoutez l’élément PermissionSet (PermissionSetType) à l’élément AdditionalProperties dans la requête GetFolder .

Voir aussi