MarkAllItemsAsRead-Vorgang

Artikel
03/29/2023

Hier finden Sie Informationen zum EWS-Vorgang MarkAllItemsAsRead .

Der MarkAllItemsAsRead-Vorgang legt die IsRead-Eigenschaft für alle Elemente in einem oder mehreren Ordnern fest, um anzugeben, dass alle Elemente entweder gelesen oder ungelesen sind.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des MarkAllItemsAsRead-Vorgangs

Der MarkAllItemsAsRead-Vorgang kann die IsRead-Eigenschaft für alle Elemente in Ordnern festlegen, die entweder durch den Ordnerbezeichner der Exchange-Webdienste (EWS) oder den Standardmäßigen Exchange-Ordnernamen identifiziert werden. Der MarkAllItemsAsRead-Vorgang kann auch das Senden von Lesebestätigungen für als gelesen markierte Elemente unterdrücken.

SOAP-Header des MarkAllItemsAsRead-Vorgangs

Der MarkAllItemsAsRead-Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Headername	Element	Beschreibung
Impersonation	ExchangeImpersonation	Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt. Dieser Header gilt für eine Anforderung.
MailboxCulture	MailboxCulture	Identifiziert die Kultur, wie in RFC 3066 "Tags für die Identifizierung von Sprachen" definiert, die für den Zugriff auf das Postfach verwendet werden soll. Dieser Header gilt für eine Anforderung.
RequestVersion	RequestServerVersion	Gibt die Schemaversion für die Vorgangsanforderung an. Dieser Header gilt für eine Anforderung.
ServerVersion	ServerVersionInfo	Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dieser Header gilt für eine Antwort.

MarkAllItemsAsRead-Vorgangsanforderungsbeispiel: Markieren aller Elemente in einem Ordner als gelesen

Das folgende Beispiel einer MarkAllItemsAsRead-Vorgangsanforderung zeigt, wie die IsRead-Eigenschaft , die auch als Leseflag bezeichnet wird, für alle Elemente in einem Ordner auf true festgelegt wird. Dieses Beispiel zeigt auch, dass Lesebestätigungen nicht als Reaktion auf Lesebestätigungsanforderungen gesendet werden.

Hinweis

Alle Elementbezeichner und Änderungsschlüssel in diesem Artikel wurden gekürzt, um die Lesbarkeit zu erhalten. Für diesen Vorgang sind keine Änderungsschlüssel erforderlich.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body>
      <m:MarkAllItemsAsRead>
         <m:ReadFlag>true</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche Antwort des MarkAllItemsAsRead-Vorgangs

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine MarkAllItemsAsRead-Vorgangsanforderung , um alle Elemente in einem Ordner als gelesen zu markieren.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" />
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <m:MarkAllItemsAsReadResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Success">
               <m:ResponseCode>NoError</m:ResponseCode>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

MarkAllItemsAsRead-Vorgangsanforderungsbeispiel: Markieren aller Elemente in einem Ordner als ungelesen

Das folgende Beispiel einer MarkAllItemsAsRead-Vorgangsanforderung zeigt, wie die IsRead-Eigenschaft für alle Elemente in einem Ordner auf false festgelegt wird. Dieses Beispiel zeigt auch, dass Lesebestätigungen nicht als Reaktion auf Lesebestätigungsanforderungen gesendet werden.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" 
               xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
   </soap:Header>
   <soap:Body>
      <m:MarkAllItemsAsRead>
         <m:ReadFlag>false</m:ReadFlag>
         <m:SuppressReadReceipts>true</m:SuppressReadReceipts>
         <m:FolderIds>
            <t:FolderId Id="AAMkADEzOTExYZRAAA=" 
                        ChangeKey="AQAAAAA3vA==" />
         </m:FolderIds>
      </m:MarkAllItemsAsRead>
   </soap:Body>
</soap:Envelope>

Eine erfolgreiche Antwort auf eine Anforderung, alle Elemente als gelesen zu markieren, entspricht der Antwort auf eine Anforderung, alle Elemente als ungelesen zu markieren.

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Fehlerantwort des MarkAllItemsAsRead-Vorgangs

Das folgende Beispiel zeigt eine Fehlerantwort auf eine MarkAllItemsAsRead-Vorgangsanforderung , um alle Elemente in einem Ordner als gelesen oder ungelesen zu markieren, wenn der Ordner nicht im Postfach vorhanden ist.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <m:MarkAllItemsAsReadResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
            <m:MarkAllItemsAsReadResponseMessage ResponseClass="Error">
               <m:MessageText>The specified object was not found in the store.</m:MessageText>
               <m:ResponseCode>ErrorItemNotFound</m:ResponseCode>
               <m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
            </m:MarkAllItemsAsReadResponseMessage>
         </m:ResponseMessages>
      </m:MarkAllItemsAsReadResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Text der Fehlerantwort enthält die folgenden Elemente:

Freigeben über