WMRMChallenge.ClientVersion

banner art

Previous Next

WMRMChallenge.ClientVersion

The ClientVersion property retrieves the security version of the DRM component on the client.

Syntax

  String = WMRMChallenge.ClientVersion

Parameters

This property takes no parameters.

Return Values

If the method succeeds, it returns a String containing the DRM component version. If it fails, it returns a number in the error object.

Remarks

The license issuer can determine which version of license to issue based on this value. For example, a client based on a version 10 DRM component supports Windows Media Rights Manager 10 licenses.

Note   To set, require, and detect individualization versions greater than 2.10, you must use version 10.1.1 or later of the Windows Media Rights Manager SDK.

This property is read-only.

Example Code

' Assume that the content packager has sent encrypted content and 
' a header to a consumer. The consumer's computer determines that 
' a license is needed and posts a challenge to the license issuer.
' The challenge contains the header sent by the content packager,
' actions requested by the client, and information about the client
' computer.
'
' For more information about the header, see the WMRMHeader object.


' Declare variables and objects.
    Dim sHeader, sClientInfo, sPubKey, lResult, dwActionCnt
    Dim sLicRequest, lIndex, sVerClient, sVerSecurity, sAppSecurity
    Dim sAction()
    Dim HeaderObj
    Dim ChallengeObj
    Dim DRMVersion

' Create objects.
    Set HeaderObj = Server.CreateObject("Wmrmobjs.WMRMHeader")
    Set ChallengeObj = Server.CreateObject("Wmrmobjs.WMRMChallenge")
  
' Retrieve the license request from the client computer.
    sLicRequest = request.Form("challenge")

' Set the license request into the WMRMChallenge object.
    ChallengeObj.Challenge = sLicRequest

' Retrieve the header from the challenge.
    sHeader = ChallengeObj.Header

' Set the header into the WMRMHeader object.
    HeaderObj.Header = sHeader

' Verify the header with the public key created by the content
' packager.
    lResult = HeaderObj.Verify(sPubKey)
    if (lResult = 0) then
        ' The header has been corrupted.
    end if

' Retrieve the DRM client version from the client.
    DRMVersion = ChallengeObj.ClientVersion

Requirements

Version: Windows Media Rights Manager 10 SDK or later

Reference: wmrmobjs 1.0 Type Library

Library: wmrmobjs.dll

Platform: Windows Server 2003

See Also

Previous Next

© 2007 Microsoft Corporation. All rights reserved.