.gif) |
WMRMRights.CopyRestrictions
The CopyRestrictions property specifies and retrieves a string that indicates which technologies can or cannot be used to copy protected content.
Syntax
WMRMRights.CopyRestrictions = String
String = WMRMRights.CopyRestrictions
Parameters
This property takes no parameters.
Return Values
If the property succeeds, it returns a String containing the copy restrictions. If it fails, it returns a number in the error object.
Remarks
You can use the WMRMRestrictions object to specify the technologies to require, include, or exclude for copying protected content. For example, you can require that content be copied to devices with at least a medium level of encryption (a protection level of 400). By default, copy restrictions are not set.
For information about current output protection levels, see the document WMRM SDK Compliance Rules that accompanied your license agreement from Microsoft.
Example Code
' Set playback and copy restrictions.
Dim RestrictObj ' WMRMRestrictions object
Dim PlayRestrictions ' Playback restrictions
Dim CopyRestrictions ' Copy restrictions
Set RestrictObj = Server.CreateObject("WMRMObjs.WMRMRestrictions")
' Set output protection levels for playback.
Call RestrictObj.AddRestriction(1, 300) ' Uncompressed digital video
Call RestrictObj.AddRestriction(2, 500) ' Compressed digital video
Call RestrictObj.AddRestriction(3, 200) ' Analog video
Call RestrictObj.AddRestriction(4, 200) ' Compressed digital audio
Call RestrictObj.AddRestriction(5, 200) ' Uncompressed digital audio
' Add an extended technology for playing analog video.
Call RestrictObj.AddExtension("{C3FD11C6-F8B7-4d20-B008-1DB17D61F2DA}", 1)
' Get the playback restrictions string.
PlayRestrictions = RestrictObj.GetRestrictions
' Set output protection levels for copying.
Set RestrictObj = Nothing
Set RestrictObj = Server.CreateObject("WMRMObjs.WMRMRestrictions")
Call RestrictObj.AddRestriction(6, 400) ' Copied output.
' Get the copy restrictions string.
CopyRestrictions = RestrictObj.GetRestrictions
' Set the restrictions in the WMRMRights object.
RightsObj.PlayRestrictions = PlayRestrictions
RightsObj.CopyRestrictions = CopyRestrictions
Requirements
Version: Windows Media Rights Manager 10 SDK
Reference: wmrmobjs 1.0 Type Library
Library: wmrmobjs.dll
Platform: Windows Server 2003
See Also