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

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

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

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

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

<!-- Initial Contributors:

    Nokia Corporation - initial contribution.

Contributors: 

-->

<!DOCTYPE task

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

<task id="GUID-11761887-0C37-46E6-A7F6-E6F7FDE7C5A1" xml:lang="en"><title>Display

Information</title><abstract><p>CAF provides APIs that allow a client application to request

an agent to display information on the screen. Some agents may not support

these calls and leave with <codeph>KErrCANotSupported</codeph>.</p><p><note> Displaying

DRM rights information is only relevant for agents implementing a DRM scheme.

It is expected that an agent implementing DRM provides some or all of the

following functionality in the dialog: <ul>

<li id="GUID-7B16E603-A3B6-5556-AC9A-5D538F63F522"><p>Display all rights objects

including state (pending, valid, expired, orphaned and so on) </p> </li>

<li id="GUID-0B0F39BB-970A-5BDF-961C-2DF5CAB4BC29"><p>Display detailed information

on a particular rights object (play count, validity period, the related content

object(s)) </p> </li>

<li id="GUID-6088EBD3-21AD-5A5A-9A10-10BDD47956C8"><p>Allow unwanted, expired

or orphaned rights to be deleted. </p> </li>

</ul></note></p></abstract><prolog><metadata><keywords/></metadata></prolog><taskbody>

<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> 

   </prereq>

<context>       <p>Purpose of the task and when it should be carried out</p> 

   </context>

<info>           <p>Before working with one particular agent, the client needs

to find out which agents are installed on the device. The <xref href="GUID-7F3D9E35-A8FC-35A6-8036-23396BAADFDC.dita#GUID-7F3D9E35-A8FC-35A6-8036-23396BAADFDC/GUID-49BBD20E-5C75-3495-A789-854B14A2EFA4"><apiname>CManager::ListAgentsL()</apiname></xref> function

provides this list of agents. The F32Agent is not included in the list, as

it does not support any management functions. </p><p>The<xref href="GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601.dita#GUID-0F5CE9B5-E674-3962-8376-CFB1ECB2F601/GUID-D510B56C-3060-3510-8EAA-7DCE30B33134"><apiname> ContentAccess::CAgent</apiname></xref> objects

in the list can be used to refer to the particular agent in subsequent function

calls.</p>         </info>

<stepxmp><codeblock xml:space="preserve">// Create a CManager object

CManager* manager = CManager::NewL();

RPointerArray <CAgent> theAgents;

// Get the list of agents 

manager->ListAgents(theAgents);

// Check there is at least one agent 

if(theAgents.Count() > 0) 

		{

			// Find the first agent 

			CAgent& agent = theAgents[0];

		}</codeblock></stepxmp>

</step>

<step id="GUID-9A1DEDD9-1DD5-4114-A6D5-ED6E80F1EF48"><cmd>Display file properties.</cmd>

<stepxmp><codeblock xml:space="preserve">

...

manager->DisplayInfoL(EFileProperties, avirtualPath);

...</codeblock></stepxmp>

</step>

<step id="GUID-E62C411C-2101-4775-AB02-52BE19A14915"><cmd>Display agent management

information.</cmd>

<info><p>The management API allows applications to request that an agent display

management information on the screen. The agent can present configuration

settings, status or DRM rights information. Each agent has the unique settings,

so it is not possible to display one dialog to configure all agents. </p><codeblock xml:space="preserve">RPointerArray &lt;CAgent&gt; theAgents;

// Get the list of agents 

manager->ListAgents(theAgents);

// Check there is at least one agent 

if(theAgents.Count() > 0) 

		{

			CAgent& agent = (*theAgents)[0];

			// Display the management information for the first agent

			manager->DisplayManagementInfoL(agent);

		}

</codeblock></info>

<info><p>It is possible that some agents do not support this capability and

leave with <codeph>KErrCANotSupported</codeph>. </p> </info>

</step>

</steps>

</taskbody><related-links>

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

CAF Agents</linktext></link>

</related-links></task>