Windows Media Rights Manager SDK banner art

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.

Windows Media release Default security version (a.b) Individualized security version (a.b)
7.x 2.1 2.2
9 Series 2.3 2.2
10 (limited beta) 2.3 2.3
10 2.3 2.4

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.

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

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