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

  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

<concept id="GUID-B5F98445-3CFF-5067-B89A-AC80F56C40C3" xml:lang="en"><title>Porting

Data Recognizers to Secure Platform</title><shortdesc>This page describes how to migrate data recognizers to the secure

version of the Symbian platform. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-322F3E8C-2835-4B73-88AD-C537A20E0329"><title>Procedure</title> <p id="GUID-37D4A6C5-1A14-5CE3-A852-1AAD412C57DA"><b>Converting

data recognizers into ECOM plugins</b> </p> <ol id="GUID-56EF676C-103E-5B68-85A1-D6A66B9EC046">

<li id="GUID-18ED65F4-B508-5DC7-8869-A5035C7922B3"><b>Changing the project

specification (.mmp) file</b> - Change the project specification (<filepath>.mmp</filepath>)

file to specify an ECOM plug-in. For example: <p><codeblock id="GUID-8AD243FE-63AE-5971-98BA-D105E2756FCA" xml:space="preserve">target            EXAMPLEREC.DLL 

targettype        PLUGIN 

UID                0x10009D8D <DLLUID> 

capability        ProtServ 

sourcepath        ..\path 

systeminclude    ..\inc 

systeminclude    ..\inc\ecom  

source            EXAMPLEREC.CPP 

start resource    <DLLUID>.RSC  

TARGET            examplerec.rsc  

library            EUSER.LIB APMIME.LIB</codeblock> </p> </li>

<li id="GUID-202CFB50-4DE2-5BD5-8F3B-03C3305DD992"><p><b>Changing the ECOM

resource file</b> - Change the ECOM resource file to specify:</p> <ul>

<li id="GUID-E0038901-3017-5B9D-9F2E-4ACC3877AEE6"><p>interface UID. This

identifies the plugin scheme, and should be <codeph>0x101F7D87</codeph> for

data recognizers </p> </li>

<li id="GUID-C4D4DAB8-DD0B-597D-A9A8-E3A202A15688"><p>implementation UID.

This uniquely identifies the plugin. </p> </li>

</ul><p>For example: </p> <codeblock id="GUID-47351321-C97D-553C-8E32-6D3F9D08C380" xml:space="preserve">#include &lt;RegistryInfo.rh&gt; 

RESOURCE REGISTRY_INFO r_registry

{ 

dll_uid = <DLLUID>;  // Should match the name of this file 

                    // The name of the resource file is <DLLUID>.rss 

interfaces =  

    { 

    INTERFACE_INFO 

        { 

        interface_uid = 0x101F7D87; // Const for all data recognizers 

        implementations = 

            { 

            IMPLEMENTATION_INFO 

                { 

                implementation_uid = <Unique Implementation Uid>;  

                version_no = 1; 

                display_name = "DataRecName"; 

                default_data = "";  

                opaque_data = ""; 

                } 

            }; 

        } 

    }; 

}</codeblock></li>

<li id="GUID-0C63777C-524D-55F3-9C17-34D2FB26A1E3"><p><b>Changing the source

code</b> - </p> Both the data recognizer's <filepath>.h</filepath> and <filepath>.cpp</filepath> files

need code adding to create the data recognizer. For example: <p><b>example.h</b> </p> <codeblock id="GUID-7571422C-2A48-53D6-8385-6F3AAA07BC3F" xml:space="preserve">

class CExampleDataRecognizer : public CApaDataRecognizerType

     {

     public:

         static CApaDataRecognizerType* CreateRecognizerL();

     };</codeblock> <p><b>example.cpp</b> </p> <codeblock id="GUID-CC663D38-25C1-58D9-8E27-054AEC4C08F4" xml:space="preserve">

CApaDataRecognizerType* CExampleDataRecognizer::CreateRecognizerL()

    {

    return new (ELeave) CExampleDataRecognizer ();

    }

const TImplementationProxy ImplementationTable[] =

    { 

    IMPLEMENTATION_PROXY_ENTRY(UNIQUE IMPLEMENTATION UID, CExampleDataRecognizer::CreateRecognizerL)

    };

EXPORT_C const TImplementationProxy* ImplementationGroupProxy(TInt& aTableCount)

    {

    aTableCount = sizeof(ImplementationTable) / sizeof(TImplementationProxy);

    return ImplementationTable;

    }

// Remove the previously EXPORTED function

EXPORT_C CApaDataRecognizerType* CreateRecognizer ()

    {

    }</codeblock></li>

</ol> <p id="GUID-7AA2AA79-4CD2-5C44-BE9B-66051E22514F"><b>Converting data

recognizers into pre-platform security style plugins</b> </p> <p>You can convert

data recognizers into plug-ins of the sort used before Platform Security was

introduced by: </p> <ol id="GUID-BC2F8B96-B270-58A2-A4BD-D09EDB7F7A7A">

<li id="GUID-BA29280D-2CE5-5E8C-8805-8D841EB364C7"><b>Changing the project

specification (.mmp) file</b> - Change the project specification (<filepath>.mmp</filepath>)

file to specify a plug-in of the style used before Platform Security was introduced.

For example: <p><codeblock id="GUID-521E33C5-9A00-5C8A-AC4A-E1D509F82DAA" xml:space="preserve">

target            EXAMPLEREC.MDL 

targettype        DLL 

UID                0x10003A37 <DLLUID> 

capability        TrustedUI ProtServ 

sourcepath        ..\path 

systeminclude    ..\inc 

source            EXAMPLEREC.CPP 

library            EUSER.LIB APMIME.LIB</codeblock> </p> </li>

<li id="GUID-757324F0-742B-5FC7-A809-DBAC0ECFA5F9"><p><b>Changing the source

code</b> - The data recognizer's <filepath>.cpp</filepath> file needs code

adding to create the data recognizer. For example:</p>  <p><b>example.cpp</b> </p> <codeblock id="GUID-A16D2566-2C14-5015-AB9B-D54FE96DB906" xml:space="preserve">EXPORT_C CApaDataRecognizerType* CreateRecognizer() 

    { 

    CExampleDataRecognizer * thing=NULL; 

    thing = new CExampleDataRecognizer(); 

    return thing; // null if new failed 

    }</codeblock></li>

</ol> </section>

<section id="GUID-C7BCBCEB-5135-4F9D-BC22-69922CE4F776"><title>See also</title> <p><xref href="GUID-1AAA88BB-19AD-5B8E-993C-11F4B7CD90EB.dita">Writing

a MIME Recognizer</xref>. </p> </section>