WMRMTools.GenerateContentRevocation
.gif)
| Previous | Next |
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.
| Return code | Description |
| 0x80048007 | An input key is not a valid Base64-encoded string. |
| 0x80048013 | The public and private packaging keys do not match. |
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
| Previous | Next |