3.1.4.1 CopyFolder

The CopyFolder operation copies an identified folder and returns the folder identifier and change key of the copied folder.<12>

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

 <wsdl:operation name="CopyFolder">
     <wsdl:input message="tns:CopyFolderSoapIn" />
     <wsdl:output message="tns:CopyFolderSoapOut" />
 </wsdl:operation>

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

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

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

A successful CopyFolder operation request returns a CopyFolderResponse element with the ResponseClass attribute of the CopyFolderResponseMessage element set to "Success" and the ResponseCode element of the CopyFolderResponse element set to "NoError".

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