WMRMRights.AllowCollaborativePlay

The AllowCollaborativePlay property specifies and retrieves a Boolean value that indicates whether the license permits consumers to play protected content in a collaborative peer-to-peer session.

Syntax

Boolean = WMRMRights.AllowCollaborativePlay
WMRMRights.AllowCollaborativePlay = Boolean

Parameters

This property takes no parameters.

Return Values

If the property succeeds, it returns a Boolean value indicating whether the content can be played in a shared session. If it fails, it returns E_FAIL.

Remarks

The default value of this property is False.

Collaborative play allows consumers who use peer-to-peer services to play protected content. For example, users of MSN Messenger 2004 can play protected content in a MusicMix session.

Up to 10 users who know each other and are connected through the Internet can join a group, sometimes called a party, that has a single shared playlist of music tracks. All concurrently connected users can be contributors by providing additional music tracks (DRM-protected or not) from their computers to the shared playlist. Each new track is then preemptively and securely distributed to all other connected party members, called listeners. The new track is securely cached on each listener's disk until it becomes the active track in the shared playlist. Then all concurrently connected users listen to the same track at the same time according to the order of the shared playlist.

The audio contained in licensed content must be downgraded by transcoding to 64 kbps before it is cached in persistent storage or transmitted over a public network. This restriction does not apply to video.

No more than 10 listeners can have a copy of the content keys at one time.

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 = True
    RightsObj.AllowPlay = True
    RightsObj.AllowCollaborativePlay = True

' 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

• Setting Rights
• WMRMRights Object