Windows Media Rights Manager SDK banner art

WMRMRights.MaxPlaylistBurnCount

The MaxPlaylistBurnCount property specifies and retrieves the number of times that content can be copied to a CD as part of a particular playlist.

Syntax

WMRMRights.MaxPlaylistBurnCount = DWORD
DWORD = WMRMRights.MaxPlaylistBurnCount

Parameters

This property takes no parameters.

Return Values

When getting the value, this property returns a DWORD containing the number of permitted copies.

Remarks

By default, this property is not set.

If the playlist is modified, for example by changing the order of the tracks or by adding or deleting tracks, the playlist is considered new and this count is reset to its original value.

After content is copied to CD, the content is no longer protected.

Notes

  • This right is not supported in a root license. For more information about license chains, see Issuing Chained Licenses.
  • If a user creates and burns a one-track playlist containing a protected file, PlaylistBurnTrackCount will be decremented but MaxPlaylistBurnCount will remain unchanged.

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.AllowBackupRestore = False
    RightsObj.AllowPlay = True
    RightsObj.AllowPlaylistBurn = True
    RightsObj.MaxPlaylistBurnCount = 5
    RightsObj.PlaylistBurnTrackCount = 15

' 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