3.1.4.1 CopyItem Operation

The CopyItem operation copies Post objects on the server. This operation is specified in [MS-OXWSCORE] section 3.1.4.1.

The following is the WSDL port type specification for the CopyItem operation.

 <wsdl:operation name="CopyItem">
      <wsdl:input message="tns:CopyItemSoapIn" />
      <wsdl:output message="tns:CopyItemSoapOut" />
 </wsdl:operation>

The following is the WSDL binding specification for the CopyItem operation.

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

The following table summarizes the set of WSDL message definitions that are specific to the CopyItem operation.

Message name

Description

CopyItemSoapIn

The CopyItemSoapIn message is specified in [MS-OXWSCORE] section 3.1.4.1.1.1. It specifies the CopyItem operation request to copy one or more Post objects on the server.

The CopyItem element ([MS-OXWSCORE] section 3.1.4.1.2.1) that specifies the XML request MUST contain the following child elements:

ToFolderId ([MS-OXWSCORE] section 2.2.4.16)

ItemIds ([MS-OXWSCORE] section 2.2.4.16)

The ItemIds element MUST contain one or more ItemId child elements ([MS-OXWSCORE] section 2.2.4.31), each one having an Id attribute ([MS-OXWSCORE] section 2.2.4.25) that identifies a Post object.

The ItemIds element MUST NOT contain an OccurrenceId child element ([MS-OXWSCORE] section 2.2.4.31) or a RecurringMasterItemId child element ([MS-OXWSCORE] section 2.2.4.31) in a request to copy a Post object.

CopyItemSoapOut

The CopyItemSoapOut message is specified in [MS-OXWSCORE] section 3.1.4.1.1.2. It specifies the server response to the CopyItem operation request.

In the response message, the Items element ([MS-OXWSCDATA] section 2.2.4.43) contains one or more PostItem elements of type PostItemType (section 2.2.4.1).

The client sends a tns:CopyItemSoapIn request WSDL message and the server MUST respond with a tns:CopyItemSoapOut response WSDL message.

Show: