3.1.4.7 MoveFolder

  • Article

The MoveFolder operation moves folders from a specified parent folder and puts them in another parent folder. All the properties, contents, and subfolders of the folder move with the folder.

The following is the WSDL port type specification of the MoveFolder operation.

 <wsdl:operation name="MoveFolder">
     <wsdl:input message="tns:MoveFolderSoapIn" />
     <wsdl:output message="tns:MoveFolderSoapOut" />
 </wsdl:operation>

The following is the WSDL binding specification of the MoveFolder operation.

 <wsdl:operation name="MoveFolder">
     <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/MoveFolder" />
     <wsdl:input>
         <soap:header message="tns:MoveFolderSoapIn" part="Impersonation" use="literal"/>
         <soap:header message="tns:MoveFolderSoapIn" part="MailboxCulture" use="literal"/>
         <soap:header message="tns:MoveFolderSoapIn" part="RequestVersion" use="literal"/>
         <soap:body parts="request" use="literal" />
     </wsdl:input>
     <wsdl:output>
         <soap:body parts="MoveFolderResult" use="literal" />
         <soap:header message="tns:MoveFolderSoapOut" part="ServerVersion" use="literal"/>
     </wsdl:output>
 </wsdl:operation>

The protocol client sends a MoveFolderSoapIn request WSDL message, and the protocol server responds with a MoveFolderSoapOut response WSDL message.

A successful MoveFolder operation request returns a MoveFolderResponse element with the ResponseClass attribute of the MoveFolderResponseMessage element set to "Success" and the ResponseCode element of the MoveFolderResponse element set to "NoError".

An unsuccessful MoveFolder operation request returns a MoveFolderResponse element with the ResponseClass attribute of the MoveFolderResponseMessage element set to "Error". The ResponseCode element of the MoveFolderResponseMessage element is set to a value of the ResponseCodeType simple type, as specified in [MS-OXWSCDATA] section 2.2.5.24.