126.96.36.199 GetVersions Subrequest
This operation is used to retrieve information about a file’s versions<52>.
The protocol client MUST send the GetVersions SubRequest message only if the X-MSFSSHTTP header, as described in [MS-OCPROTO] section 188.8.131.52.2, has a value of 1.1 or greater. The protocol client sends a GetVersions SubRequest message, which is of type GetVersionsSubRequestType as specified in section 184.108.40.206. The protocol server responds with a GetVersions SubResponse message, which is of type GetVersionsSubResponseType as specified in section 220.127.116.11. 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 18.104.22.168 and section 22.214.171.124. 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 126.96.36.199, and the SubResponse element is defined in section 188.8.131.52. The Results element, as specified in [MS-VERSS] section 184.108.40.206, 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.