PreCertify method

Article
05/31/2018

[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 PreCertify SOAP web method retrieves a certificate that can be used to acquire a license for a user account.

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 PrecertifyResponse[] PreCertify(
  PrecertifyParams[] RequestParams
);

VB
`Public Function PreCertify( _ ByVal RequestParams() As PrecertifyParams _ ) As PrecertifyResponse()`

Parameters

RequestParams: An array of PrecertifyParams objects that identify the end users to be certified.

Note

If you pass more than one array item (one user), the AD RMS server throws a System.ArgumentException object.

Return value

An array of PrecertifyResponse objects that contain the public portions of the rights account certificates for the specified users.

Note

The array can contain only one PrecertifyResponse object because only one user can be specified on input.

Web Service URL

ServerURL/_wmcs/Certification/Precertification.asmx

Remarks

Unlike the AcquirePreLicense method, the PreCertify method can precertify accounts in different forests. To use this method to retrieve an end user license, first determine which forest the user resides in, call PreCertify on the AD RMS server in that forest, acquire the issuance license (usually from the protected content), and then call AcquireLicense on the server in the current forest.

Requirements


Product	Rights Management Services 1.0 SP2 or later