<?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-33108CC9-3FF7-4076-A512-FB6F2F0BCC0D" xml:lang="en"><title>Retrieving application information using filters</title><shortdesc>This tutorial describes how application information can

be retrieved from the SCR using filters.</shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<prereq id="GUID-ED7444CA-D1AF-4617-91E6-ABEBFEBD6259"><p>The Client

applications must link against <filepath>scrclient.dll</filepath>. </p></prereq>

<steps id="GUID-4DD07DEC-6017-4237-BE46-1D69E5FBD744-GENID-1-12-1-5-1-1-6-1-6-1-4-1-5-1-3-2">

<step id="GUID-9A69E5AD-E938-4092-A8C2-CB65C37C8962-GENID-1-12-1-5-1-1-6-1-6-1-4-1-5-1-3-2-1"><cmd>Connect

to the SCR server.</cmd>

<info><codeblock xml:space="preserve">#include &lt;usif/scr/scr.h&gt;

Usif::RSoftwareComponentRegistry scrSession;

scrSession.Connect();

</codeblock></info>

</step>

<step id="GUID-52B25417-323F-46D8-B572-A65C4B1F8DBA-GENID-1-12-1-5-1-1-6-1-6-1-4-1-5-1-3-2-2"><cmd>Create an

object of <codeph>RApplicationInfoView</codeph>.</cmd>

<info><codeblock xml:space="preserve">RApplicationInfoView subSession;</codeblock></info>

</step>

<step id="GUID-5EECC6C2-C7EF-48DF-ABB0-2D0F237B00C8"><cmd>Create a

filter object of <codeph>CAppInfoFilter</codeph>.</cmd>

<info><codeblock xml:space="preserve">CAppInfoFilter* infoFilter;

infoFilter = CAppInfoFilter::NewL();

</codeblock></info>

</step>

<step id="GUID-4E3FED58-9FB4-474D-BFD9-30267D4054B8"><cmd>Set the

filter object properties.</cmd>

<info><codeblock xml:space="preserve">// embeddability filter (the extent to which the application can be embedded) 

// and screen mode (size of the screen)

// The filter used below is used to list applications filtered by whether they are 

// embeddable and  have a screen mode value of zero

Usif::TEmbeddableFilter embedibilityFilter;

embedibilityFilter.AddEmbeddability(EEmbeddable)

infoFilter->SetEmbeddabilityFilterWithScreenMode(embedibilityFilter,0);

</codeblock></info>

</step>

<step id="GUID-90F67FCC-E2E4-4BFD-927F-AF59651B8A2D-GENID-1-12-1-5-1-1-6-1-6-1-4-1-5-1-3-2-5"><cmd>Open a <xref href="GUID-5DD9E56F-CDBC-3BBC-B949-8FE10F29152B.dita"><apiname>RApplicationInfoView</apiname></xref>  subsession with the filter.</cmd>

<info><codeblock xml:space="preserve">subSession.OpenViewL(scrSession,infoFilter);

</codeblock></info>

</step>

<step id="GUID-0D7AF719-87D6-4191-96AE-23193C58C236-GENID-1-12-1-5-1-1-6-1-6-1-4-1-5-1-3-2-6"><cmd>Retrieve

the information using <xref href="GUID-5DD9E56F-CDBC-3BBC-B949-8FE10F29152B.dita#GUID-5DD9E56F-CDBC-3BBC-B949-8FE10F29152B/GUID-8B1BB35A-91A3-3E74-82F8-B3A56542551D"><apiname>RApplicationInfoView::GetNextAppInfoL()</apiname></xref>.</cmd>

<info><codeblock xml:space="preserve">// GetNextAppInfoL() takes two parameters. The number of  entries to be fetched 

// in a single call and an output parameter of type <codeph>RPointerArray</codeph>

// for returning the array.

TInt noOfEntries = 5;

RPointerArray<TAppRegInfo> infoSet;

do {

   .....

   .....

   infoSet.ResetAndDestroy();

   subSession.GetNextAppInfoL(noOfEntries, infoSet);

   }while(0 != infoSet.Count());

</codeblock></info>

</step>

</steps>

</taskbody></task>