GetLicensorCertificate method

[The AD RMS SDK leveraging functionality exposed by the client in Msdrm.dll is available for use in Windows Server 2008, Windows Vista, Windows Server 2008 R2, Windows 7, Windows Server 2012, and Windows 8. It may be altered or unavailable in subsequent versions. Instead, use Active Directory Rights Management Services SDK 2.1, which leverages functionality exposed by the client in Msipc.dll.]

The GetLicensorCertificate SOAP web method returns the active server licensor certificate chain.

Note

This SOAP web method is documented as if it were used in a .NET Framework XML web service client. For more information about creating an XML web service client, see Building XML Web Service Clients and Accessing XML Web Services in Managed Code.

Syntax

public LicensorCertChain GetLicensorCertificate();

VB
Public Function GetLicensorCertificate() As LicensorCertChain

Parameters

This method has no parameters.

Return value

This method returns the active server licensor certificate chain.

If an error occurs, this method will throw a SoapException. The inner exception will be a serialized exception that contains additional information about the error. Some of the more common inner exceptions are listed in the Exceptions section.

Web Service URL

ServerURL/_wmcs/Licensing/Server.asmx

Remarks

The VersionDataValue and Credentials properties of the SOAP proxy object must be set before calling this method.

The AD RMS server licensor certificate chain holds the AD RMS public key used to identify the deployment and encrypt the content key in an issuance license. This certificate chain can be used in DRMGetSignedIssuanceLicense, when using that function with the DRM_SERVER_ISSUANCELICENSE flag to get the string unsigned issuance license chain. However, you must first convert it into an acceptable chain by using the DRMConstructCertificateChain function.

Requirements

Product
Rights Management Services 1.0 SP2 or later

See also

AD RMS SOAP Web Methods

LicensorCertChain