3.1.4.3 CreateManagedFolder

  • Article

The CreateManagedFolder operation creates a managed folder in the server message store.

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

 <wsdl:operation name="CreateManagedFolder">
     <wsdl:input message="tns:CreateManagedFolderSoapIn" />
     <wsdl:output message="tns:CreateManagedFolderSoapOut" />
 </wsdl:operation>

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

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

A managed folder is created by an administrator and placed in a user's mailbox for messaging records management purposes. The retention and journaling of messages in managed folders are controlled by managed content settings that are applied to the folder.

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

A successful CreateManagedFolder operation request returns a CreateManagedFolderResponse element with the ResponseClass attribute of the CreateManagedFolderResponseMessage element set to "Success" and the ResponseCode element of the CreateManagedFolderResponse element set to "NoError".

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