3.1.4.2 Common Fault Codes

The RMS: ISV Extension Protocol notifies a requestor of application-level faults by generating SOAP fault code (as specified in [SOAP1.1] section 4.4). In the SOAP fault, the <faultcode> element contains the type of exception being thrown. The <faultstring> element contains the text of the exception being thrown.

The following table summarizes the exceptions that the server can return to the requestor.

 Exception

 Description

System.ArgumentNullException

.NET exception.

Microsoft.DigitalRightsManagement.Core.MalformedDataVersionException

A client request contained an invalid version number that cannot be processed.

Microsoft.DigitalRightsManagement.Core.UnsupportedDataVersionException

The data version the client requested is not supported.

The server SHOULD validate the <VersionData> element of the request. If the <MinimumVersion> element or the <MaximumVersion> element do not contain a valid version number as specified in section 2.2.4.2, the server SHOULD return a Microsoft.DigitalRightsManagement.Core.MalformedDataVersionException SOAP fault code. If the <MaximumVersion> element contains a version number that is higher than the range supported by the server for the operation, the server SHOULD return a Microsoft.DigitalRightsManagement.Core.UnsupportedDataVersionException SOAP fault code. If any input element required for successful processing of the operation is set to NULL, the server SHOULD return a System.ArgumentNullException SOAP fault code.