FindFolder-Vorgang

Artikel
29.03.2023

Der FindFolder-Vorgang verwendet Exchange-Webdienste, um Unterordner eines identifizierten Ordners zu suchen, und gibt einen Satz von Eigenschaften zurück, die den Satz von Unterordnern beschreiben.

FindFolder gibt nur die ersten 512 Bytes einer streambaren Eigenschaft zurück. Bei Unicode werden nur die ersten 255 Zeichen mit einer Unicode-Zeichenfolge zurückgegeben, die mit null endet.

Tiefe Durchlaufabfragen können nicht für öffentliche Ordner ausgeführt werden.

Einschränkungen sind zulässig und sollten nur die Ordnereigenschaften und nicht die Elementeigenschaften verwenden. Die Sortierfunktion ist für FindFolder-Antworten nicht verfügbar. Gruppierte Abfragen sind für FindFolder-Abfragen nicht verfügbar.

[! HINWEIS} Der FindFolder-Vorgang wird auch verwendet, um verwaltete Ordner zu suchen.

SOAP-Header

Der FindFolder-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt und beschrieben werden.

Header	Element	Beschreibung
Identitätswechsel	ExchangeImpersonation	Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt.
MailboxCulture	MailboxCulture	Gibt die RFC3066-Kultur an, die für den Zugriff auf das Postfach verwendet wird.
RequestVersion	RequestServerVersion	Gibt die Schemaversion für die Vorgangsanforderung an.
ServerVersion	ServerVersionInfo	Gibt die Version des Servers an, der auf die Anforderung geantwortet hat.
TimeZoneContext	TimeZoneContext	Gibt die Zeitzone für alle Antworten vom Server an.

FindFolder-Anforderungsbeispiel

Das folgende Beispiel einer FindFolder-Anforderung zeigt, wie eine Anforderung zum Suchen aller Ordner in einem Posteingang erstellt wird.

XML

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

Mithilfe des Standardwerts für die BaseShape gibt die Antwort den Ordnernamen, die Ordner-ID, die Anzahl der Unterordner, die Anzahl der im Ordner gefundenen untergeordneten Ordner und die Anzahl der ungelesenen Elemente zurück.

FindFolder-Anforderungselemente

Diese FindFolder-Anforderung enthält die folgenden Elemente:

Weitere FindFolder-Anforderungselemente finden Sie im Schema.

FindFolder-Antwortbeispiel

Das folgende SOAP-Textbeispiel (Simple Object Access Protocol) zeigt eine erfolgreiche Antwort auf die FindFolder-Anforderung . Die Antwort enthält die Elemente, die zurückgegeben werden, wenn der Standardwert für die BaseShape verwendet wird.

Hinweis

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

XML

<?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="652" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <FindFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                        xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                        xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:FindFolderResponseMessage ResponseClass="Success">
          <m:ResponseCode>NoError</m:ResponseCode>
          <m:RootFolder TotalItemsInView="1" IncludesLastItemInRange="true">
            <t:Folders>
              <t:Folder>
                <t:FolderId Id="AQAnAH" ChangeKey="AQAAABY" />
                <t:DisplayName>TestFolder</t:DisplayName>
                <t:TotalCount>0</t:TotalCount>
                <t:ChildFolderCount>0</t:ChildFolderCount>
                <t:UnreadCount>0</t:UnreadCount>
              </t:Folder>
            </t:Folders>
          </m:RootFolder>
        </m:FindFolderResponseMessage>
      </m:ResponseMessages>
    </FindFolderResponse>
  </soap:Body>
</soap:Envelope>

FindFolder-Antwortelemente

Die eigenschaften, die in der Antwort zurückgegeben werden, werden von der BaseShape und den AdditionalProperties bestimmt, sofern sie verwendet werden. Eine erfolgreiche FindFolder-Antwort enthält die folgenden Elemente:

FindFolder-Antworten auf eine Anforderung mit dem AllProperties-Antwort-Shape geben die Elemente TotalCount und UnreadCount für Die Suche nach öffentlichen Ordnern nicht zurück.

FindFolder-Fehlerantwortbeispiel

Das folgende SOAP-Textbeispiel zeigt eine Fehlerantwort, die auftritt, wenn Sie nach einem Ordner suchen, der durch einen falsch formatierten Ordnerbezeichner identifiziert wird.

XML

<?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="652" MinorBuildNumber="0" 
                         xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <FindFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                          xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
                          xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
      <m:ResponseMessages>
        <m:FindFolderResponseMessage ResponseClass="Error">
          <m:MessageText>Id is malformed.</m:MessageText>
          <m:ResponseCode>ErrorInvalidIdMalformed</m:ResponseCode>
          <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
        </m:FindFolderResponseMessage>
      </m:ResponseMessages>
    </FindFolderResponse>
  </soap:Body>
</soap:Envelope>

FindFolder-Fehlerantwortelemente

Die FindFolder-Fehlerantwort enthält die folgenden Elemente:

Weitere Informationen

Das Ordner-Element DisplayName (string) ist immer in der Standardform enthalten.
Das UnreadCount-Element ist in den Ordnern Aufgaben und Notizen enthalten.
Verwenden Sie den PropertyTag-Wert von 0x672D mit dem Eigenschaftstyp Integer , um einen verwalteten Ordner mithilfe des ExtendedFieldURI-Elements zu identifizieren.

Siehe auch

Suchen von Ordnern

Teilen über