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, which supports Windows Media DRMĀ for Portable Devices.

Syntax

WMRMRights.AllowCopy = BooleanBoolean = 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.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 or later

Reference: wmrmobjs 1.0 Type Library

Library: wmrmobjs.dll

Platform: Windows Server 2003

See Also