Compartir a través de

Operación GetFolder

  • Artículo

La operación GetFolder obtiene carpetas del almacén de Exchange.

Ejemplo de solicitud GetFolder

Descripción

En el ejemplo siguiente de una solicitud GetFolder se muestra cómo obtener un identificador de carpeta, un nombre para mostrar, el número de elementos de esa carpeta, el número de carpetas secundarias y el número de elementos no leídos de la carpeta.

Código

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

Elementos Request

Esta solicitud GetFolder incluye los siguientes elementos:

Consulte el esquema para ver los elementos adicionales que puede usar para formar una solicitud GetFolder .

Nota:

El esquema que describe este elemento se encuentra en el directorio virtual IIS que hospeda los servicios Web Exchange.

Ejemplo de respuesta GetFolder

Descripción

El siguiente ejemplo de cuerpo de Simple Object Access Protocol (SOAP) muestra una respuesta correcta a la solicitud GetFolder .

Nota:

El identificador de carpeta y la clave de cambio se han acortado para conservar la legibilidad.

Código

<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="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetFolderResponse 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: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>

Elementos de respuesta

Esta respuesta GetFolder incluye los siguientes elementos:

Ejemplo de respuesta de error GetFolder

Descripción

En el siguiente ejemplo de cuerpo SOAP se muestra una respuesta de error causada por un FolderId incorrecto en la solicitud.

Código

<?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="http://schemas.microsoft.com/exchange/services/2006/types" />
  </soap:Header>
  <soap:Body>
    <GetFolderResponse 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: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>

Elementos de respuesta

Esta respuesta de error GetFolder incluye los siguientes elementos:

Diferencias de versión

En el caso de las aplicaciones que tienen como destino Exchange Online, Exchange Online como parte de Office 365 o una versión local de Exchange a partir de Exchange 2013, los permisos de carpeta no se devuelven cuando el elemento BaseShape tiene un valor de AllProperties en la solicitud de operación GetFolder. Para recuperar permisos de carpeta, agregue el elemento PermissionSet (PermissionSetType) al elemento AdditionalProperties de la solicitud GetFolder .

Vea también