Operación MarkAllItemsAsReadMarkAllItemsAsRead operation

Buscar información sobre la operación de EWS de MarkAllItemsAsRead .Find information about the MarkAllItemsAsRead EWS operation.

La operación MarkAllItemsAsRead establece la propiedad IsRead en todos los elementos de una o varias carpetas para indicar que todos los elementos son leídos o no leídos.The MarkAllItemsAsRead operation sets the IsRead property on all items, in one or more folders, to indicate that all items are either read or unread.

Esta operación se introdujo en Exchange Server 2013.This operation was introduced in Exchange Server 2013.

Uso de la operación MarkAllItemsAsReadUsing the MarkAllItemsAsRead operation

La operación MarkAllItemsAsRead puede establecer la propiedad IsRead en todos los elementos de las carpetas identificadas por el identificador de la carpeta de servicios web Exchange (EWS) o el nombre de la carpeta de Exchange predeterminada.The MarkAllItemsAsRead operation can set the IsRead property on all items in folders identified by either the Exchange Web Services (EWS) folder identifier or the default Exchange folder name. La operación MarkAllItemsAsRead también puede suprimir el envío de confirmaciones de lectura para los elementos marcados como leídos.The MarkAllItemsAsRead operation can also suppress the sending of read receipts for items marked as read.

Encabezados SOAP de operación MarkAllItemsAsReadMarkAllItemsAsRead operation SOAP headers

La operación MarkAllItemsAsRead puede usar los encabezados SOAP que se enumeran en la tabla siguiente.The MarkAllItemsAsRead operation can use the SOAP headers that are listed in the following table.

Nombre de encabezadoHeader name ElementoElement DescripciónDescription
SuplantaciónImpersonation
ExchangeImpersonationExchangeImpersonation
Identifica al usuario que está suplantando la aplicación cliente.Identifies the user whom the client application is impersonating. Este encabezado se aplica a una solicitud.This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
Identifica la referencia cultural, tal y como se define en RFC 3066, "etiquetas para la identificación de idiomas", que se va a usar para obtener acceso al buzón.Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. Este encabezado se aplica a una solicitud.This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
Identifica la versión del esquema para la solicitud de operación.Identifies the schema version for the operation request. Este encabezado se aplica a una solicitud.This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
Identifica la versión del servidor que respondió a la solicitud.Identifies the version of the server that responded to the request. Este encabezado se aplica a una respuesta.This header is applicable to a response.

Ejemplo de solicitud de operación MarkAllItemsAsRead: marcar todos los elementos de una carpeta como leídosMarkAllItemsAsRead operation request example: Mark all items in a folder as read

El siguiente ejemplo de una solicitud de operación de MarkAllItemsAsRead muestra cómo establecer la propiedad IsRead , que también se denomina marca de lectura, en true en todos los elementos de una carpeta.The following example of a MarkAllItemsAsRead operation request shows how to set the IsRead property, which is also called the read flag, to true on all items in a folder. En este ejemplo también se muestra que no se envían confirmaciones de lectura en respuesta a las solicitudes de confirmación de lectura.This example also shows that read receipts are not sent in response to any read receipt requests.

Nota

Todos los identificadores de elemento y las claves de cambio de este artículo se han reducido para preservar la legibilidad.All item identifiers and change keys in this article have been shortened to preserve readability. Las claves de cambio no son necesarias para esta operación.Change keys are not required for this operation.

<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://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>

El cuerpo SOAP de la solicitud contiene los siguientes elementos:The request SOAP body contains the following elements:

Respuesta de operación MarkAllItemsAsRead correctaSuccessful MarkAllItemsAsRead operation response

En el ejemplo siguiente se muestra una respuesta correcta a una solicitud de operación MarkAllItemsAsRead para marcar todos los elementos de una carpeta como leídos.The following example shows a successful response to a MarkAllItemsAsRead operation request to mark all items in a folder as read.

<?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="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://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>

El cuerpo SOAP de respuesta contiene los siguientes elementos:The response SOAP body contains the following elements:

Ejemplo de solicitud de operación MarkAllItemsAsRead: marcar todos los elementos de una carpeta como no leídosMarkAllItemsAsRead operation request example: Mark all items in a folder as unread

El siguiente ejemplo de una solicitud de operación de MarkAllItemsAsRead muestra cómo establecer la propiedad IsRead en false en todos los elementos de una carpeta.The following example of a MarkAllItemsAsRead operation request shows how to set the IsRead property to false on all items in a folder. En este ejemplo también se muestra que no se envían confirmaciones de lectura en respuesta a las solicitudes de confirmación de lectura.This example also shows that read receipts are not sent in response to any read receipt requests.

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages" 
               xmlns:t="https://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>

Una respuesta correcta a una solicitud para marcar todos los elementos como leídos es la misma que la respuesta a una solicitud para marcar todos los elementos como no leídos.A successful response to a request to mark all items as read is the same as the response to a request to mark all items as unread.

El cuerpo SOAP de la solicitud contiene los siguientes elementos:The request SOAP body contains the following elements:

Respuesta de error de operación de MarkAllItemsAsReadMarkAllItemsAsRead operation error response

En el ejemplo siguiente se muestra una respuesta de error a una solicitud de operación MarkAllItemsAsRead para marcar todos los elementos de una carpeta como leídos o no leídos cuando la carpeta no existe en el buzón.The following example shows an error response to a MarkAllItemsAsRead operation request to mark all items in a folder as read or unread when the folder does not exist in the mailbox.

<?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="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://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="https://schemas.microsoft.com/exchange/services/2006/messages" 
                                    xmlns:t="https://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>

El cuerpo SOAP de respuesta de error contiene los siguientes elementos:The error response SOAP body contains the following elements:

Vea tambiénSee also