WMRMKeys.GenerateKeyID

WMRMKeys.GenerateKeyID

The GenerateKeyID method creates a globally unique key ID.

Syntax

  String
  
  =
  
  WMRMKeys
  .GenerateKeyID()

Parameters

This method takes no parameters.

Return Values

If the method succeeds, it returns a String containing the base64-encoded key ID. If it fails, it returns a number in the error object.

Remarks

The key ID is a globally unique identifier (GUID). The GenerateKeyID method does not change the persistence of the key ID in the WMRMKeys object.

Although it is possible to use custom key IDs, issues may arise on the client for various reasons, such as if the custom value is too short, if it includes nonstandard characters, and if it is not base64-encoded. These issues can be avoided by generating key IDs using GenerateKeyID.

Example Code

      Dim sKID, sCID, sSeed, sKey, sHeader
    Dim sPrivKey, sPubKey
    Dim HeaderObj
    Dim KeysObj
    Dim ProtectObj

' Create objects.

    Set HeaderObj = Server.CreateObject("Wmrmobjs.WMRMHeader")
    Set KeysObj = Server.CreateObject("Wmrmobjs.WMRMKeys")
    Set ProtectObj = Server.CreateObject("Wmrmobjs.WMRMProtect")




















' Require individualization version 2.2.
' Version numbers change. Verify that this number is up to date.

.IndividualizedVersion="2.2"
















HeaderObj.SetCheckSum(sKey)

' Replace XXX with the packaging server's private key. 

    = "XXX"

' Sign the header.



' Retrieve the string containing the header.

    sHeader = HeaderObj.Header

' Set the header string into the WMRMProtect object.

    ProtectObj.Header = sHeader

' Set the key into the WMRMProtect object.

    ProtectObj.Key = sKey

' Specify the name of the file to be protected.

    ProtectObj.InputFile = "c:\input_file.wmv"

' Generate a protected file.

    ProtectObj.ProtectFile("c:\output_file_1.wmv")

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

• WMRMKeys Object
• WMRMKeys.GenerateKey
• WMRMKeys.KeyID

© 2007 Microsoft Corporation. All rights reserved.