1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE task

    11   PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

    12 <task id="GUID-AA9A960A-1070-46B3-BA9B-4D43ACFB5E32" xml:lang="en"><title>Create

    13 a DRM Rights Management Object</title><abstract><p>The rights management object is only relevant for agents implementing

    14 a DRM scheme. Other agents leaves with <codeph>KErrCANotSupported</codeph>. </p> </abstract><prolog><metadata><keywords/></metadata></prolog><taskbody>

    15 <prereq>       <p>The manager object must be created using the <xref href="GUID-7F3D9E35-A8FC-35A6-8036-23396BAADFDC.dita#GUID-7F3D9E35-A8FC-35A6-8036-23396BAADFDC/GUID-2F4CB027-777F-3F16-AE9A-8902F4AE87E7"><apiname>CManager::NewL()</apiname></xref> function. </p> 

    16    </prereq>

    17 <steps-unordered>

    18 <step id="GUID-AEBD05D6-0240-4A48-B70C-A53D0357575F"><cmd>An application can

    19 ask a particular DRM agent to create a <xref href="GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601.dita#GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601/GUID-2CBEF3AA-7101-3247-BAED-79B624CEBBD1"><apiname>ContentAccess::CRightsManager</apiname></xref> object

    20 that can be used to provide generic access to DRM rights within that agent.

    21 Since it is a generic interface used by all agents, it may not possible to

    22 present all the detailed information available.</cmd>

    23 <stepxmp><codeblock xml:space="preserve">CRightsManager *rightsmanager;

    24 // Create a CManager object

    25 

    26 ...

    27 

    28 // create the rights manager object for a particular agent 

    29 rightsManager = manager->CreateRightsManagerL(agent); 

    30 

    31 // do rights management stuff</codeblock></stepxmp>

    32 <info><p>To manage the rights in a more comprehensive manner, the application

    33 must use the <xref href="GUID-671191B1-B249-3DD3-A5E8-6F1A41A371C8.dita#GUID-671191B1-B249-3DD3-A5E8-6F1A41A371C8/GUID-D66CD794-B4C4-3C99-B4F8-04080FB7AC9F"><apiname>ContentAccess::CManager::DisplayManagementInfoL()</apiname></xref> function,

    34 where the agent can present its own comprehensive information. </p></info>

    35 </step>

    36 </steps-unordered>

    37 </taskbody><related-links>

    38 <link href="GUID-E99E0092-5F1D-5715-945E-E83C307357C3.dita"><linktext>Managing

    39 CAF Agents</linktext></link>

    40 </related-links></task>