GetFolder-Vorgang

  • Artikel

Der GetFolder-Vorgang ruft Ordner aus dem Exchange-Speicher ab.

GetFolder-Anforderungsbeispiel

Beschreibung

Das folgende Beispiel einer GetFolder-Anforderung zeigt, wie Sie einen Ordnerbezeichner, einen Anzeigenamen, die Anzahl der Elemente in diesem Ordner, die Anzahl der untergeordneten Ordner und die Anzahl der ungelesenen Elemente im Ordner abrufen.

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>

Anfordern von Elementen

Diese GetFolder-Anforderung enthält die folgenden Elemente:

Weitere Elemente, die Sie zum Erstellen einer GetFolder-Anforderung verwenden können, finden Sie im Schema.

Hinweis

Das Schema, das dieses Element beschreibt, befindet sich im virtuellen IIS-Verzeichnis, das Exchange-Webdienste hostet.

GetFolder-Antwortbeispiel

Beschreibung

Das folgende SOAP-Textbeispiel (Simple Object Access Protocol) zeigt eine erfolgreiche Antwort auf die GetFolder-Anforderung .

Hinweis

Die Ordner-ID und der Änderungsschlüssel wurden gekürzt, um die Lesbarkeit zu erhalten.

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>

Antwortelemente

Diese GetFolder-Antwort enthält die folgenden Elemente:

Beispiel für getFolder-Fehlerantwort

Beschreibung

Das folgende SOAP-Textbeispiel zeigt eine Fehlerantwort, die durch eine falsche FolderId in der Anforderung verursacht wird.

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>

Antwortelemente

Diese GetFolder-Fehlerantwort enthält die folgenden Elemente:

Versionsunterschiede

Für Anwendungen, die auf Exchange Online, Exchange Online als Teil von Office 365 oder einer lokalen Version von Exchange ab Exchange 2013 abzielen, werden Ordnerberechtigungen nicht zurückgegeben, wenn das BaseShape-Element in der GetFolder-Vorgangsanforderung den Wert AllProperties aufweist. Um Ordnerberechtigungen abzurufen, fügen Sie dem AdditionalProperties-Element in der GetFolder-Anforderung das Element PermissionSet (PermissionSetType) hinzu.

Siehe auch