3.1.4.1 Common SOAP Headers
The interfaces of the Rights Management Services (RMS): ISV Extension Protocol use the same SOAP header for both requests and responses. The SOAP header for requests and responses to these interfaces MUST contain the VersionData element specified in section 2.2.4.3.
Request
When a request is made, the requestor MUST specify the lowest capability version it can support as the <MinimumVersion> parameter. The client MUST specify the highest capability version it can support as the <MaximumVersion> parameter. The client MUST make the request in accordance with the <MaximumVersion> capability version.
|
Parameter |
Description |
|---|---|
|
<MinimumVersion> |
MUST specify the lowest capability version supported by the requestor. |
|
<MaximumVersion> |
MUST specify the highest capability version supported by the requestor. |
Data Processing
When a responder receives a request, it MUST compare its own capability version to the capability version range presented by the requestor. The responder MUST assume that the requestor always makes a maximum-version request. The responder MUST reject the request with an error if its highest capability version is lower than the <MaximumVersion> specified by the requestor. The responder MUST throw the Microsoft.DigitalRightsManagement.Core.MalformedDataVersionException exception if the <MinimumVersion> specified by the requestor is higher than the <MaximumVersion> specified by the requestor.
Response
When responding to a requestor, including when responding with an error, the responder MUST specify the lowest capability version it can support as the <MinimumVersion> parameter. The responder MUST specify the highest capability version it can support as the <MaximumVersion> parameter. If the responder's maximum capability version is lower than the requestor's maximum capability version, the requestor SHOULD resend its request and alter its request to conform to the capability version range specified by the responder.<3>