AcquireContentKey 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 AcquireContentKey SOAP web method acquires a decrypted content key from a server that has been decommissioned.

[!Important]
It is very important to understand that only approved computers or (occasionally) users should have access to this function because anyone with access to this function can obtain a decrypted content key.

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 AcquireContentKeyResponse[] AcquireContentKey(
  AcquireContentKeyParams[] paramsSoap
);

VB
`Public Function AcquireContentKey( _ ByVal paramsSoap() As AcquireContentKeyParams _ ) As AcquireContentKeyResponse()`

Parameters

paramsSoap: An array of AcquireContentKeyParams objects that contain the issuance licenses to obtain the decrypted content key for.

Return value

An array of AcquireContentKeyResponse objects that contain the decrypted content keys.

Web Service Description Page

ServerURL/_wmcs/Decommission/Decommission.asmx

Remarks

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

For this web method to succeed, the server must have been decommissioned by the administrator and the proper access control lists (ACLs) must have been set on the virtual root of the server. For more information about decommissioning, see the AD RMS product documentation.

Requirements


Product	Rights Management Services 1.0 SP2 or later