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 concept

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

    12 <concept id="GUID-FF312AAD-E40B-5238-A31C-B34AFD892D5A" xml:lang="en"><title>Static

    13 interface DLLs</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <p>A static interface DLL represents an interface which is defined to its

    15 clients by one or more headers for use at compile time, and an import library

    16 for use at link time. </p>

    17 <p>When a executable that is a client of the DLL is loaded at run-time, the

    18 loader notes that it requires the static interface DLL to be available. The

    19 loader then either loads the DLL or, if it is loaded already, attaches the

    20 new client to it. </p>

    21 <p>In Symbian platform, all static interface DLLs must have a <codeph>uid2</codeph> of <codeph>0x1000008d</codeph>.

    22 The particular static interface DLL is then identified by name and by <codeph>uid3</codeph>. </p>

    23 <p>For example, if a DLL called <filepath>helloview.dll</filepath> is built

    24 with a <codeph>uid3</codeph> of 0x10000252, then the name used in the import

    25 library for ARM builds of Symbian platform is <filepath>helloview[10000252]</filepath>.

    26 When the loader loads the <filepath>helloview.dll</filepath>, it checks that

    27 its UID is <codeph>0x10000252</codeph>. If the <codeph>uid3</codeph> in the

    28 DLL does not match, then the load fails. </p>

    29 <section><title>mmp project specification</title><p>A static interface DLL

    30 project file must specify the correct target type and UID:</p><ul>

    31 <li id="GUID-EBD5092A-1F8F-5715-AFB4-A8183263028C"><p>Specify the <codeph>TARGETTYPE</codeph> line

    32 as: </p> <codeblock id="GUID-0BF51E79-4F88-58FC-9608-C57F1C8F6FF0" xml:space="preserve">TARGETTYPE dll</codeblock> <p>This

    33 implicitly specifies <codeph>UID1</codeph> correctly. </p> </li>

    34 <li id="GUID-2FB86A73-A3D3-5289-B5C3-5D3CE68EE68C"><p>Specify the UID for

    35 the DLL in a <codeph>UID</codeph> line: </p> <p><userinput>UID 0x1000008d

    36 &lt;UID3&gt;</userinput> </p> </li>

    37 </ul> </section>

    38 <example><p>An example of the <filepath>mmp</filepath> project file for a

    39 static DLL is given below: </p><codeblock id="GUID-0690A3DC-3FF4-5FA1-9532-7ED2A0E65C1B" xml:space="preserve">TARGET        CreateStaticDLL.dll

    40 TARGETTYPE    dll

    41 UID           0x1000008d 0x10004268

    42 SOURCEPATH    .

    43 SOURCE        CreateStaticDLL.cpp

    44 USERINCLUDE   .

    45 SYSTEMINCLUDE \Epoc32\include

    46 LIBRARY       euser.lib

    47 EXPORTUNFROZEN</codeblock></example>

    48 </conbody></concept>