.gif) |
WMRMRights Object
The WMRMRights object specifies the rights that a license grants to the consumer.
All licenses containing rights created by using the WMRMRights object are deleted when the license can no longer be used. If no operations have been counted, the license deletes itself when it expires. If operations have been counted, the license deletes itself after all the counts have been used or the license expires, whichever comes first.
The WMRMRights object exposes the following properties and methods.
| Property | Description |
| AllowBackupRestore | Specifies and retrieves a Boolean value that indicates whether the license permits backup and restoration. |
| AllowBurnToCD | Specifies and retrieves a Boolean value that indicates whether the license permits content to be copied to a CD in the Red Book audio format.
This right has been deprecated and replaced by AllowPlaylistBurn. |
| AllowCollaborativePlay | Specifies and retrieves a Boolean value that indicates whether the license permits consumers to play protected content in a collaborative peer-to-peer session. |
| AllowCopy | Specifies and retrieves a Boolean value that indicates whether the license permits content to be copied. |
| AllowPlay | Specifies and retrieves a Boolean value that indicates whether the license permits content to be played on a client computer or device. |
| AllowPlaylistBurn | Specifies and retrieves a Boolean value that indicates whether the license permits content to be copied to CD as part of a playlist. |
| AllowPlayOnPC | Specifies and retrieves a Boolean value that indicates whether the license permits content to be played on a client computer.
This right has been deprecated and replaced by AllowPlay. |
| AllowSaveStreamProtected | Not currently supported. |
| AllowTransferToNonSDMI | Specifies and retrieves a Boolean value that indicates whether the license permits content to be transferred to portable devices or portable media that support Portable Device DRM version 1 or Windows Media DRM 10 for Portable Devices, and are not SDMI-compliant. |
| AllowTransferToSDMI | Specifies and retrieves a Boolean value that indicates whether the license permits content to be transferred to SDMI-compliant portable devices or portable media that support Portable Device DRM version 1 or Windows Media DRM 10 for Portable Devices. |
| BeginDate | Specifies and retrieves the date before which the license is not valid. |
| BurnToCDCount | Specifies and retrieves the number of times that content can be copied to a CD.
This right is no longer supported. It has been replaced by replaced by MaxPlaylistBurnCount and PlaylistBurnTrackCount. |
| CopyCount | Specifies and retrieves the number of times that content can be copied. |
| CopyRestrictions | Specifies and retrieves a string that indicates which technologies can or cannot be used to copy protected content. |
| DeleteOnClockRollback | Specifies and retrieves a Boolean value that indicates whether a license must be deleted if the clock is set to an earlier time. |
| DisableOnClockRollback | Specifies and retrieves a Boolean value that indicates whether a license must be disabled if the clock is set to an earlier time. |
| ExcludeApplication | Specifies the application ID of a player that you want to prevent from accessing your protected files. |
| ExpirationAfterFirstUse | Specifies and retrieves the license expiration in number of hours, beginning when the license is first used. |
| ExpirationDate | Specifies and retrieves the date after which the license is no longer valid. |
| ExpirationOnStore | Specifies and retrieves the number of hours that a license is valid, beginning when the license is first stored on the consumer's computer. |
| GracePeriod | Specifies and retrieves the number of hours during which protected content can be played on a device after its clock becomes unset. |
| MaxPlaylistBurnCount | Specifies and retrieves the number of times that content can be copied to a CD as part of a particular playlist. |
| MinimumAppSecurity | Specifies and retrieves the minimum security level that a player must have to use the content.
This right has been deprecated and replaced by MinimumSecurityLevel. |
| MinimumClientSDKSecurity | Specifies and retrieves the minimum security level of the Windows Media Format SDK on which the client application is based. |
| MinimumSecurityLevel | Specifies and retrieves the minimum security level that a player must have to use the content. |
| Playcount | Specifies and retrieves the number of times the license permits the content to be played. |
| PlaylistBurnTrackCount | Specifies and retrieves the total number of times that content can be copied to a CD as part of any playlist. |
| PlayRestrictions | Specifies and retrieves a string that indicates which technologies can or cannot be used to play protected content. |
| PMAppSecurity | Specifies and retrieves the security level for content that is being transferred to portable devices or portable media.
This right has been deprecated and replaced by MinimumSecurityLevel and MinimumClientSDKSecurity. |
| PMExpirationDate | Specifies and retrieves the expiration date for a portable license.
This right is no longer supported. |
| PMRights | Specifies and retrieves the rights that govern content use with a portable license.
This right is no longer supported. |
| TransferCount | Specifies and retrieves the number of times the content can be transferred to portable devices or portable media. |
| Method | Description |
| GetAllRights | Packages all rights into a string for delivery to the WMRMLicGen object. |
| GetSAPMode | Retrieves the secure audio path (SAP) mode required for a license. |
| Reset | Resets the internal state of the rights object. |
| SetSAPMode | Specifies the SAP mode required for a license. |
See Also