Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The GetListItemChanges operation is used to retrieve the list items that have been inserted or updated after the specified date and time, and that match the specified filter criteria. Protocol clients need to use the GetListItemChangesSinceToken operation (section 3.1.4.22) in place of this protocol server because this operation does not return list items that have been deleted on the protocol server.
-
<wsdl:operation name="GetListItemChanges"> <wsdl:input message="GetListItemChangesSoapIn" /> <wsdl:output message="GetListItemChangesSoapOut" /> </wsdl:operation>
The protocol client sends a GetListItemChangesSoapIn request message (section 3.1.4.21.1.1) and the protocol server responds with a GetListItemChangesSoapOut response message (section 3.1.4.21.1.2), as follows:
If the specified since date-time is an empty string or an invalid date-time string, the protocol server MUST return a SOAP fault. There is no error code for this fault.
If the specified listName is an empty string, the protocol server SHOULD<63> return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or might have been deleted by another user.
If the specified listName is a valid GUID and corresponds to the identification of a list on the site, use that list.
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.
If listName does not correspond to a list from either of these checks, the protocol server SHOULD<64> return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or might have been deleted by another user.
Otherwise, all list items in the list specified by the listName parameter that match the criteria based on the since and contains parameters MUST be returned, unless the protocol server encounters an unexpected situation and MUST return a SOAP fault.