Windows Media Rights Manager SDK banner art

WMRMRights.AllowCopy

The AllowCopy property specifies and retrieves a Boolean value that indicates whether the license permits content to be copied to a device, such as a portable player or portable media, that supports Windows Media DRM 10 for Portable Devices.

Syntax

WMRMRights.AllowCopy = Boolean
Boolean = WMRMRights.AllowCopy

Parameters

This property takes no parameters.

Return Values

If the property succeeds, it returns a Boolean value indicating whether the content can be copied. If it fails, it returns E_FAIL.

Remarks

The default value of this property is False.

The AllowCopy right is typically enabled in a subscription model, when a subscription service wants to require the use of devices that are based on Windows Media DRM for Portable Devices. In addition, a copy protection level is usually specified in combination with the AllowCopy right by using the WMRMRestrictions object.

However, in a purchase model, typically, the AllowTransferToSDMI and AllowTransferToNonSDMI rights are used for allowing content to be transferred to devices.

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
    Dim RestrictObj

' 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.AllowCopy = True
    RightsObj.CopyCount = 10

' Set copy restrictions.
    Set RestrictObj = Server.CreateObject("WMRMObjs.WMRMRestrictions")
    Call RestrictObj.AddRestriction(6, 400)
    RightsObj.CopyRestrictions = RestrictObj.GetRestrictions

' 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