3.1.4.23 GetListItemChangesWithKnowledge

  • Article

The GetListItemChangesWithKnowledge operation is used to return changes made to a specified list after the event expressed by the knowledge parameter, if specified, or to return all the list items in the list.<72>

 <wsdl:operation name="GetListItemChangesWithKnowledge">
     <wsdl:input message="GetListItemChangesWithKnowledgeSoapIn" />
     <wsdl:output message="GetListItemChangesWithKnowledgeSoapOut" />
 </wsdl:operation>

The protocol client sends a GetListItemChangesWithKnowledgeSoapIn request message (section 3.1.4.23.1.1) and the protocol server responds with a GetListItemChangesWithKnowledgeSoapOut response message (section 3.1.4.23.1.2), as follows:

  1. If the specified listName is a valid GUID and corresponds to the identification of a list on the site, use that list.

  2. If the specified listName is not a valid GUID or does not correspond to the identification of a list on the site, check if the listName corresponds to the list title of a list on the site and if so, use that list.

  3. If the specified listName does not correspond to a list from either of these checks, the protocol server MUST return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or could have been deleted by another user.

  4. If the viewFields parameter is not specified and the viewName parameter contains a correctly formatted GUID and refers to a view that does not exist, the protocol server MUST return a SOAP fault with error code 0x82000005. If the viewFields parameter is not specified and the viewName parameter does not contain a correctly formatted GUID or if the viewFields parameter is specified, the server MUST ignore the viewName parameter.

  5. If the value of the knowledge parameter is empty or is not of a valid format, the protocol server MUST return a SOAP fault. There is no error code for this fault.

  6. Otherwise, all list items specified by the listName parameter that match the criteria passed in MUST be returned, unless the protocol server encounters an unexpected situation and MUST return a SOAP fault. There is no specific error code for this fault.