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.