IRMGetLicense::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

HRESULT GetDRMSecurityVersion(
  BSTR*  pbstrDRMSecurityVersion
);

Parameters

pbstrDRMSecurityVersion

[out] Pointer to a string identifying the version of the DRM component of the consumer's player.

Return Values

This method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

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.

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

• IRMGetLicense Interface
• Issuing Licenses Based on Client Version and Individualization Information