3.1.5.1.2 GetLatestDocumentVersion

  • Article

This method retrieves the version of the presentation. In cases other than that of a presentation broadcast, the URL to this method is constructed by appending _layouts/MobilePresentation.ashx to the site name. The parameters to be passed while calling this method are as follows:

presentationId: A unique identifier for a presentation as specified in section 2.2.3.1. This parameter is optional. If the parameter is specified, the URL MUST be absolute or relative. If the parameter is not specified or if it is empty, then it MUST be auto generated.

getCurrentDocVersion: An xsd:string element ([XMLSCHEMA2] section 3.2.1) that specifies if the version of the document is to be returned. If this parameter is set to true, the server MUST return the version. For any other legal string, the server MUST ignore this parameter and treat this call as the GetMetaDataXml method (section 3.1.5.1.1) call.

Also, the scheme of the URL MUST match the scheme of the presentationId if the presentationId is being passed as an absolute URL.

In case of a presentation broadcast, the URL to this method is constructed by replacing PowerpointFrame.aspx with MobilePresentation.ashx in the attendee URL. An attendee URL is contained in the BroadcastGetAttendeeUrlResponse defined in [MS-PWBHPS] section 3.1.4.3.2.2. Only the getCurrentDocVersion parameter needs to be passed to the protocol server in this case.

If any of the preceding conditions about the parameters are not satisfied, the method returns an error.

This method MUST send back to the protocol client an HTTP response that MUST be in the following table.

Value

Description

200

If successful, the protocol server sets an X-DocVersion HTTP header (section 2.2.2.1) which specifies the version of the presentation. An X-DocUrl HTTP header (section 2.2.2.2) is present (except in the case of a presentation broadcast).

All other cases MUST be treated as failure by the protocol client.

503

Failure. The server also sets an HTTP header X-Error (section 2.2.2.3) in the response. If 100 <= value < 200, the protocol client SHOULD retry this call, else this header MUST be ignored.