Share via

3.1.4.5 EmptyFolder

  • Article

The EmptyFolder operation empties identified folders<13> and can be used to delete the subfolders of the specified folder. When a subfolder is deleted, the subfolder and the messages within the subfolder are deleted.<14>

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

 <wsdl:operation name="EmptyFolder">
     <wsdl:input message="tns:EmptyFolderSoapIn" />
     <wsdl:output message="tns:EmptyFolderSoapOut" />
 </wsdl:operation>

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

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

The protocol client sends an EmptyFolderSoapIn request WSDL message, and the protocol server responds with an EmptyFolderSoapOut response WSDL message.

A successful EmptyFolder operation request returns an EmptyFolderResponse element with the ResponseClass attribute of the EmptyFolderResponseMessage element set to "Success" and the ResponseCode element of the EmptyFolderResponse element set to "NoError".

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