Windows Media Rights Manager SDK banner art

WMRMRights.MinimumSecurityLevel

The MinimumSecurityLevel property specifies and retrieves the minimum security level that a player must have to use the content.

Syntax

WMRMRights.MinimumSecurityLevel = DWORD
DWORD = WMRMRights.MinimumSecurityLevel 

Parameters

This property takes no parameters.

Return Values

If the property succeeds, it returns a DWORD containing the security level. If it fails, it returns E_FAIL, 0x80004005.

Remarks

When a consumer tries to play the Windows Media file, the minimum security level specified in the license is compared to the security level of the player application or device. The result determines whether the Windows Media file can be played.

When specifying a minimum security level for your Windows Media files, consider whether you want your Windows Media files to be available to a wide market (require a low security level) or whether you want to restrict playback of your Windows Media files to very secure players and devices (require a higher security level).

The following table shows examples of application security levels for different players and devices.

Security level Players and devices Example
150 Devices that do not support Windows Media DRM. DRM protection is removed when the content is transferred to such a device. Devices that support Windows Media-based content but not protected content
1,000

(default)

Player applications based on Windows Media Format 9.5 SDK and earlier that do not meet additional requirements for level 2000.

Devices based on Windows Media Portable Device DRM v1.

Devices based on Windows CE 4.2 and later.

Windows Media Player 6.4, Windows Media Player 7
2,000 Player applications based on Windows Media Format 9 Series SDK or later, and that follow a stricter set of content protection guidelines than applications at level 1000.

Devices based on Windows Media DRM 10 for Portable Devices.

Devices based on Windows Media DRM 10 for Network Devices.

Windows Media Player 9 Series and later

Portable media devices that support Windows Media DRM 10 for Portable Devices

Windows Mobile-based Portable Media Centers

Example Code

' Before you can issue a license, you must specify the consumer's
' rights and set them in the WMRMLicGen object.

' Declare objects.
    Dim sRights
    Dim RightsObj
    Dim LicGenObj

' Create objects.
    Set RightsObj = Server.CreateObject("Wmrmobjs.WMRMRights")
    Set LicGenObj = Server.CreateObject("Wmrmobjs.WMRMLicGen")

' Reset the WMRMRights object.
    RightsObj.Reset()

' Specify the rights that will be granted to the consumer.
    RightsObj.MinimumSecurityLevel = 1000
    RightsObj.AllowBackupRestore = True
    RightsObj.AllowPlay = True
    RightsObj.BeginDate = "#20050101Z#"
    RightsObj.ExpirationDate = "#20051231Z#"
    RightsObj.DisableOnClockRollback = True

' Retrieve the string containing the rights.
    sRights = RightsObj.GetAllRights()

' Set the rights in the license generator.
    LicGenObj.Rights = sRights

' Continue the license issuing process.

Requirements

Version: Windows Media Rights Manager 10 SDK

Reference: wmrmobjs 1.0 Type Library

Library: wmrmobjs.dll

Platform: Windows Server 2003

See Also