4.6 UpdateFolder Operation

  • Article

The following is an example of an UpdateFolder operation with the UpdateFolderType complex type. This example modifies the display name of the identified folder to "Modified Custom Folder".

The client constructs the XML and sends it to the server. The FolderId element Id and ChangeKey attributes have been shortened to preserve readability.

   <?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="Exchange2010" />
     </soap:Header>
     <soap:Body>
       <m:UpdateFolder>
         <m:FolderChanges>
           <t:FolderChange>
             <t:FolderId Id="AAMkAGIwODEy" ChangeKey="AQAAABQAAAA" />
             <t:Updates>
               <t:SetFolderField>
                 <t:FieldURI FieldURI="folder:DisplayName" />
                 <t:Folder>
                   <t:DisplayName>Modified Custom Folder</t:DisplayName>
                 </t:Folder>
               </t:SetFolderField>
             </t:Updates>
           </t:FolderChange>
         </m:FolderChanges>
       </m:UpdateFolder>
     </soap:Body>
   </soap:Envelope>

The server constructs the response XML and sends it to the client. The FolderId element Id and ChangeKey attributes have been shortened to preserve readability.

   <?xml version="1.0" encoding="utf-8"?>
   <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
     <s:Header>
       <h:ServerVersionInfo MajorVersion="14" 
           MinorVersion="1" 
           MajorBuildNumber="63" 
           MinorBuildNumber="0" 
           Version="Exchange2010" 
           xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" 
           xmlns="http://schemas.microsoft.com/exchange/services/2006/types" 
           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" />
     </s:Header>
     <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
       <m:UpdateFolderResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" 
             xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
         <m:ResponseMessages>
           <m:UpdateFolderResponseMessage ResponseClass="Success">
             <m:ResponseCode>NoError</m:ResponseCode>
             <m:Folders>
               <t:Folder>
                 <t:FolderId Id="AAMkAGIwODEy" ChangeKey="AQAAABYAAA" />
               </t:Folder>
             </m:Folders>
           </m:UpdateFolderResponseMessage>
         </m:ResponseMessages>
       </m:UpdateFolderResponse>
     </s:Body>
   </s:Envelope>ap:Envelope>