3.1.4.31.2.2 UpdateListItemsResponse

The UpdateListItemsResponse element contains the protocol server response to the UpdateListItems request (section 3.1.4.31).

 <s:element name="UpdateListItemsResponse">
   <s:complexType>
     <s:sequence>
       <s:element minOccurs="0" maxOccurs="1" name="UpdateListItemsResult">
         <s:complexType mixed="true">
           <s:sequence>
             <s:element name="Results" >
               <s:complexType>
                 <s:sequence>
                   <s:element name="Result" maxOccurs="unbounded">
                     <s:complexType>
                       <s:sequence>
                         <s:element name="ErrorCode" type="s:string" />
                                                 <s:any minOccurs="0" maxOccurs="unbounded" />
                       </s:sequence>
                       <s:attribute name="ID" type="s:string" />
                       <s:attribute name="List" type="s:string"/>
                       <s:attribute name="Version" type="s:string"/>
                     </s:complexType>
                   </s:element>
                 </s:sequence>
               </s:complexType>
             </s:element>
           </s:sequence>
         </s:complexType>
       </s:element>
     </s:sequence>
   </s:complexType></s:element>
  

UpdateListItemsResult: If the OnError attribute of the Batch element is set to Return, there MUST be a Result element for each Method operation. If a Method operation fails, all subsequent Method operations in the Batch MUST fail with an error of 0x800704c7. If the OnError attribute of the Batch element is set to Continue, each Method corresponds to a Result. The outcome of a Method operation MUST NOT affect the other Method operations. The ID attribute of the Method parameters MUST correspond to the ID attribute of the Result element and the Result ID is the Method ID, followed by a comma, followed by the Method operation. The List and Version attributes MUST be returned if a Method operation fails with an error of 0x81020015. The List attribute MUST be the GUID associated with the list on which the operation is finished. The Version attribute MUST be the owshiddenversion contained in the UpdateListItems request plus 1.

The Result element MUST contain an ErrorCode element. The ErrorCode element is a string representation of a hexadecimal number indicating whether the operation succeeded or failed. If an operation completes successfully, the value of the ErrorCode MUST be set to 0x00000000. An empty ID element following the ErrorCode element is included, which is reserved for future use. Otherwise, the ErrorCode MUST be set to a hexadecimal representation of the error encountered and the ErrorText element MUST have a description of the error.

If the operation succeeded, the z:row element MUST contain the updated data for the list item that is operated on. On failure, the z:row element MUST contain the list item data that exists on the server if the list item specified in the request exists.

Common errors that MAY be encountered in an UpdateListItemsResponse are specified in the following table.

ErrorCode

Error description

0x81020015

This error code MUST be used to specify a data conflict. The changes requested conflict with those made previously by another protocol client.

0x81020014

This specifies a generic error has been encountered, such as an invalid value being specified for a Field.

0x81020016

This specifies that the list item referred to in the request does not exist.