Share via

3.1.4.25 GetVersionCollection

  • Article

The GetVersionCollection operation<76> is used to return version information for the specified field of a specified list item within a specified list.

 <wsdl:operation name="GetVersionCollection">
     <wsdl:input message="GetVersionCollectionSoapIn" />
     <wsdl:output message="GetVersionCollectionSoapOut" />
 </wsdl:operation>

The protocol client sends a GetVersionCollectionSoapIn request message (section 3.1.4.25.1.1) and the protocol server responds with a GetVersionCollectionSoapOut response message (section 3.1.4.25.1.2), as follows:

  1. If the strListItemID is null or an empty string, the protocol server MUST return a SOAP fault with error code 0x82000001. This indicates that the parameter strListItemID is missing or invalid.

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

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

  4. If the specified strListID does not correspond to a list from either of these checks, the protocol server SHOULD<77> return a SOAP fault with error code 0x82000006. This indicates that the list does not exist or might have been deleted by another user.

  5. If the strListItemID does not correspond to a list item in a specified list on the site, the protocol server MUST return a SOAP fault to indicate that the strListItemID parameter is missing or invalid. When strListItemID is a negative value, the error code is 0x81020014. When strListItemID is zero or a positive value that does not correspond to a list item in a specified list on the site, there is no error code.<78>

  6. Check to make sure the specified strFieldName corresponds to a field in the specified list item of a specified list on the site.

  7. If the strFieldName does not correspond to a field in a specified list item of a specified list on the site, the protocol server MUST return a SOAP fault. There is no error code for this fault.

  8. If the protocol client excludes one or more parameters or if the strListID is null, the protocol server MUST return a SOAP fault. There is no error code for this fault.

  9. If the protocol client passes valid input parameters, the protocol server MUST return the version collection.