RMGetLicense.GetDRMSecurityVersion

RMGetLicense.GetDRMSecurityVersion

The GetDRMSecurityVersion method retrieves information about the DRM component running on the consumer's computer in the form a.b.c.d, where a.b is the release version, c is reserved, and d is the category.

Syntax

  bstrDRMSecurityVersion = GetLicense.GetDRMSecurityVersion

Parameters

This method takes no parameters.

Return Values

This method returns a String containing a string identifying the version of the DRM component of the consumer's player. If it fails, it returns a number in the error object.

Remarks

You can use this method to determine whether a player is individualized by using client-side scripting. For example, if you determine a player is not individualized, you can trigger individualization by embedding a player in a Web page that opens a dummy file that requires individualization.

The following table lists the possible values of the a.b portion of bstrDRMSecurityVersion.

For d, the category, an even value indicates a default, non-individualized component. An odd value indicates an individualized component. For example, a default installation of Windows Media Player 10 might return a value of 2.3.0.0. An individualized version of Windows Media Player 9 Series might return 2.2.0.1.

Notes   If a DRM component has been both individualized and upgraded, the security version may have a different value from the table above.

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.

For the latest individualization version information, see the Microsoft Web site https://licenseserver.windowsmedia.com/.

Requirements

Version: Windows Media Rights Manager 7 SDK or later

Reference: msnetobj 1.0 Type Library

Library: msnetobj.dll

Platform: Windows Server 2003

See Also

• Issuing Licenses Based on Client Version and Individualization Information
• Predelivering a License By Using the GetLicenseFromURL Method
• Predelivering a License By Using the GetSystemInfo Method
• RMGetLicense Object

© 2007 Microsoft Corporation. All rights reserved.