188.8.131.52 GetVersions Subrequest
This operation is used to retrieve information about a file’s versions<44>.
The protocol client MUST send the GetVersions SubRequest message only if the X-MSFSSHTTP header, as described in [MS-OCPROTO] section 184.108.40.206.2, has a value of 1.1 or greater. The protocol client sends a GetVersionsSubRequest message, which is of type GetVersionsSubRequestType as specified in section 220.127.116.11. The protocol server responds with a GetVersionsSubResponse message, which is of type GetVersionsSubResponseType as specified in section 18.104.22.168. This is done as follows:
The protocol client prepares a request containing a URL for the file, a unique request token, and one or more SubRequest elements, as defined in section 22.214.171.124 and section 126.96.36.199. The SubRequest element is of type "GetVersions".
The protocol server receives the request and parses the logic to request information about a file’s versions. The requested file version data is prepared as a response and sent back to the protocol client.
The Response element is defined in section 188.8.131.52, and the SubResponse element is defined in section 184.108.40.206. The Results element, as specified in [MS-VERSS] section 220.127.116.11, is a complex type that specifies information about the file’s versions.
The protocol returns results based on the following conditions:
If the processing of the GetVersions subrequest by the protocol server failed to get the requested versions information or encountered an unknown exception, the protocol server returns an error code value set to "SubRequestFail".
Otherwise, the protocol server sets the error code value to "Success" to indicate success in processing the GetVersions subrequest.