WMRMTools.GenerateContentRevocation

WMRMTools.GenerateContentRevocation

The GenerateContentRevocation method is used by content owners or content packagers to generate a content revocation string. When this string is included in a license, all licenses for files packaged by the content owner or content packager are disabled on the computer to which the license was issued.

Syntax

  String = WMRMTools
  .GenerateContentRevocation(

  
  bstrContentOwnerPrivateKey
  ,

  
  dwSequenceNumber
  ,

  
  bstrContentOwnerPublicKey
  ,

  
  bstrLicenseServerPublicKey
  ,

  
  vsrReserved

  )

Parameters

bstrContentServerPrivateKey

[in] String containing the packaging server's private key that was used to package the file.

dwSequenceNumber

[in] DWORD containing the sequence number of the revocation list. This parameter is for future use and should be set to 1.

bstrContentServerPublicKey

[in] String containing the packaging server's public key that was used to package the file.

bstrLicenseServerPublicKey

[in] String containing the public key of the licensing server. Optional.

This value is located in the registry in the following key:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\WM Rights Manager\License Server\Infop

Before putting this value into this parameter, replace the characters "/" and "+" with "*".

vsrReserved

[in] Variant is reserved for future use.

Return Values

This method returns a String containing the content revocation string. If the method fails, it returns a number in the error object.

Remarks

A content revocation string can be specific to a particular licensing server. If multiple license issuers work with the revoked packaged files, you can generate a separate content revocation string for each license issuer by specifying a value for the bstrLicenseServerPublicKey parameter. You must also obtain each licensing server's public key before using this method. If you do not specify this parameter, any licensing server can use the content revocation string.

After generating the content revocation string, you must share it with the license issuer so that the string can be included in licenses. Then, on every computer that receives a license with this string, all files that were packaged with the content owner's public and private key pair are revoked and their licenses are rendered invalid.

After licenses are revoked for packaged files, the content packager should generate a new set of signing keys using the WMRMKeys.GenerateSigningKeys method.

Requirements

Version: Windows Media Rights Manager 7 SDK or later

Reference: wmrmobjs 1.0 Type Library

Library: wmrmobjs.dll

Platform: Windows Server 2003

See Also

• Revoking Packaged Files
• WMRMLicGen.AddContentRevocation
• WMRMTools Object

© 2007 Microsoft Corporation. All rights reserved.