Share via


AcquirePreLicense 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 AcquirePreLicense SOAP web method returns one use license for a proxy use license requester.

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 AcquirePreLicenseResponse[] AcquirePreLicense(
  AcquirePreLicenseParams[] RequestParams
);

VB
Public Function AcquirePreLicense( _
  ByVal RequestParams() As AcquirePreLicenseParams _
) As AcquirePreLicenseResponse()

Parameters

RequestParams

An array of AcquirePreLicenseParams objects that contain information required for one or more use license requests.

Note

Servers will only accept requests that consist of arrays that contain a single element. All other requests will fail.

Return value

An array of AcquirePreLicenseResponse objects that contain the signed use license, if granted.

Web Service URL

ServerURL/_wmcs/Licensing/License.asmx

Remarks

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

This function retrieves a signed use license that corresponds to one issuance license. Prelicensing is done on behalf of the license recipient by a service, such as Microsoft SharePoint Team Services. The purpose of this function is to enable a publisher to request a use license at publishing time so that it can provide an end user with all the required licenses to consume a piece of content without having to contact a server.

The returned certificate chain contains the common chain for the license. When a client receives this response, it must construct a certificate chain that a rights management consuming application can use as described in AcquirePreLicenseResponse.

Note that you cannot use Passport identification to acquire a use license by using this function. The only way Passport identification can be used to acquire a use license is for the end user to request the license by using the DRMAcquireLicense function.

Requirements

Product
Rights Management Services 1.0 SP2 or later

See also

AD RMS SOAP Web Methods

AcquireIssuanceLicense

AcquirePreLicenseParams

AcquirePreLicenseResponse