8 Contributors: |
8 Contributors: |
9 --> |
9 --> |
10 <!DOCTYPE concept |
10 <!DOCTYPE concept |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
12 <concept id="GUID-A137553F-3B5D-5116-A793-66BF257F42B4" xml:lang="en"><title>Rights |
12 <concept id="GUID-A137553F-3B5D-5116-A793-66BF257F42B4" xml:lang="en"><title>Rights |
13 Manager API Tutorial</title><shortdesc>Applications can use the <apiname>ContentAccess::CRightsManager</apiname> class |
13 Manager API Tutorial</title><shortdesc>Applications can use the <codeph>ContentAccess::CRightsManager</codeph> class |
14 to manage Digital Rights Management (DRM) rights within a particular DRM agent. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
14 to manage Digital Rights Management (DRM) rights within a particular DRM agent. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
15 <section><title>Required background</title> <p>Before you start, you must |
15 <section id="GUID-B080A3A2-FDD5-4F98-B3FE-D68D5A49B237"><title>Required background</title> <p>Before you start, you must |
16 understand: </p> <ul> |
16 understand: </p> <ul> |
17 <li id="GUID-07B8B672-591F-5188-A6B6-A8369627CCA0"><p> <xref href="GUID-84B6389A-55CC-53EB-8725-65F753FD7217.dita"> Content |
17 <li id="GUID-07B8B672-591F-5188-A6B6-A8369627CCA0"><p> <xref href="GUID-84B6389A-55CC-53EB-8725-65F753FD7217.dita"> Content |
18 Access Framework for DRM</xref> </p> </li> |
18 Access Framework for DRM</xref> </p> </li> |
19 <li id="GUID-DB0B1394-6A5F-50DD-B730-9B7D70EDEE6F"><p> <xref href="GUID-29677CD7-DC09-590E-85AC-FF563233A205.dita"> Digital |
19 <li id="GUID-DB0B1394-6A5F-50DD-B730-9B7D70EDEE6F"><p> <xref href="GUID-29677CD7-DC09-590E-85AC-FF563233A205.dita"> Digital |
20 Rights Management</xref> </p> </li> |
20 Rights Management</xref> </p> </li> |
21 </ul> </section> |
21 </ul> </section> |
22 <section><title>Introduction</title> <p>Rights Manager API gives simple access |
22 <section id="GUID-A89F8ADE-7820-4867-8BE8-0165E3A4BB35"><title>Introduction</title> <p>Rights Manager API gives simple access |
23 to the rights within a CAF agent implementing a DRM scheme. The rights are |
23 to the rights within a CAF agent implementing a DRM scheme. The rights are |
24 represented in a generic form using the <xref href="GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601.dita#GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601/GUID-1C5F342A-2425-33C6-9769-90B3EC98A213"><apiname>ContentAccess::CRightsInfo</apiname></xref> class. |
24 represented in a generic form using the <xref href="GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601.dita#GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601/GUID-1C5F342A-2425-33C6-9769-90B3EC98A213"><apiname>ContentAccess::CRightsInfo</apiname></xref> class. |
25 This class holds a text description of the rights and some simple properties |
25 This class holds a text description of the rights and some simple properties |
26 associated with these rights. </p> <p>Rights Manager API also allows applications |
26 associated with these rights. </p> <p>Rights Manager API also allows applications |
27 to determine which content files are associated with each rights object and |
27 to determine which content files are associated with each rights object and |
28 vice versa. </p> </section> |
28 vice versa. </p> </section> |
29 <section><title>Procedure</title> <ol id="GUID-0DAC3612-40B3-5CA7-A931-D06A94658C40"> |
29 <section id="GUID-B18DBC90-1E91-41E8-8153-5BEEEEAA5559"><title>Procedure</title> <ol id="GUID-0DAC3612-40B3-5CA7-A931-D06A94658C40"> |
30 <li id="GUID-AB4439A9-3CF6-51F8-AB1B-381E7A8CD399"><p> <xref href="GUID-A137553F-3B5D-5116-A793-66BF257F42B4.dita#GUID-A137553F-3B5D-5116-A793-66BF257F42B4/GUID-A5D2126D-E744-5376-88E4-40AC9BFF92A4">Create a DRM rights management object</xref>. </p> </li> |
30 <li id="GUID-AB4439A9-3CF6-51F8-AB1B-381E7A8CD399"><p> <xref href="GUID-A137553F-3B5D-5116-A793-66BF257F42B4.dita#GUID-A137553F-3B5D-5116-A793-66BF257F42B4/GUID-A5D2126D-E744-5376-88E4-40AC9BFF92A4">Create a DRM rights management object</xref>. </p> </li> |
31 <li id="GUID-A0E3D75A-BFC7-5F7D-A58D-00B0C0323642"><p>Perform one or more |
31 <li id="GUID-A0E3D75A-BFC7-5F7D-A58D-00B0C0323642"><p>Perform one or more |
32 of the following tasks as per your requirement: </p> <ul> |
32 of the following tasks as per your requirement: </p> <ul> |
33 <li id="GUID-340B8678-49FF-5B40-B9B2-BA5FD6E60CA2"><p> <xref href="GUID-A137553F-3B5D-5116-A793-66BF257F42B4.dita#GUID-A137553F-3B5D-5116-A793-66BF257F42B4/GUID-1E57BE18-5EFF-587C-A263-2606BE557DC4">List all rights objects</xref>. </p> </li> |
33 <li id="GUID-340B8678-49FF-5B40-B9B2-BA5FD6E60CA2"><p> <xref href="GUID-A137553F-3B5D-5116-A793-66BF257F42B4.dita#GUID-A137553F-3B5D-5116-A793-66BF257F42B4/GUID-1E57BE18-5EFF-587C-A263-2606BE557DC4">List all rights objects</xref>. </p> </li> |
34 <li id="GUID-23853DD9-B8F1-5EF3-A462-C08BF134C563"><p> <xref href="GUID-A137553F-3B5D-5116-A793-66BF257F42B4.dita#GUID-A137553F-3B5D-5116-A793-66BF257F42B4/GUID-080F1FCA-ACC0-52F6-8BA7-7CC2DB52F2E0">List the rights associated with a content file</xref>. </p> </li> |
34 <li id="GUID-23853DD9-B8F1-5EF3-A462-C08BF134C563"><p> <xref href="GUID-A137553F-3B5D-5116-A793-66BF257F42B4.dita#GUID-A137553F-3B5D-5116-A793-66BF257F42B4/GUID-080F1FCA-ACC0-52F6-8BA7-7CC2DB52F2E0">List the rights associated with a content file</xref>. </p> </li> |
107 allows an application to delete rights stored by the agent. <codeblock xml:space="preserve">// Delete the rights object |
107 allows an application to delete rights stored by the agent. <codeblock xml:space="preserve">// Delete the rights object |
108 TInt result = rightsManager->DeleteRightsObject(aRightsObject);</codeblock> </p><p>It |
108 TInt result = rightsManager->DeleteRightsObject(aRightsObject);</codeblock> </p><p>It |
109 is also possible to delete all the rights associated with a particular content |
109 is also possible to delete all the rights associated with a particular content |
110 object. </p><codeblock xml:space="preserve">// Delete all the rights objects associated with the given content object |
110 object. </p><codeblock xml:space="preserve">// Delete all the rights objects associated with the given content object |
111 TInt result = rightsManager->DeleteAllRights(virtualPath);</codeblock> </section> |
111 TInt result = rightsManager->DeleteAllRights(virtualPath);</codeblock> </section> |
112 <section><title>See also</title> <p> <xref href="GUID-920CF819-645B-5705-8017-C1FAD7C6ABAF.dita">Manager |
112 <section id="GUID-64D1E9E3-775F-4B50-8469-78F6600E4852"><title>See also</title> <p> <xref href="GUID-920CF819-645B-5705-8017-C1FAD7C6ABAF.dita">Manager |
113 API Tutorials</xref> </p> </section> |
113 API Tutorials</xref> </p> </section> |
114 </conbody></concept> |
114 </conbody></concept> |