<?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-FF312AAD-E40B-5238-A31C-B34AFD892D5A" xml:lang="en"><title>Static
interface DLLs</title><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>A static interface DLL represents an interface which is defined to its
clients by one or more headers for use at compile time, and an import library
for use at link time. </p>
<p>When a executable that is a client of the DLL is loaded at run-time, the
loader notes that it requires the static interface DLL to be available. The
loader then either loads the DLL or, if it is loaded already, attaches the
new client to it. </p>
<p>In Symbian platform, all static interface DLLs must have a <codeph>uid2</codeph> of <codeph>0x1000008d</codeph>.
The particular static interface DLL is then identified by name and by <codeph>uid3</codeph>. </p>
<p>For example, if a DLL called <filepath>helloview.dll</filepath> is built
with a <codeph>uid3</codeph> of 0x10000252, then the name used in the import
library for ARM builds of Symbian platform is <filepath>helloview[10000252]</filepath>.
When the loader loads the <filepath>helloview.dll</filepath>, it checks that
its UID is <codeph>0x10000252</codeph>. If the <codeph>uid3</codeph> in the
DLL does not match, then the load fails. </p>
<section><title>mmp project specification</title><p>A static interface DLL
project file must specify the correct target type and UID:</p><ul>
<li id="GUID-EBD5092A-1F8F-5715-AFB4-A8183263028C"><p>Specify the <codeph>TARGETTYPE</codeph> line
as: </p> <codeblock id="GUID-0BF51E79-4F88-58FC-9608-C57F1C8F6FF0" xml:space="preserve">TARGETTYPE dll</codeblock> <p>This
implicitly specifies <codeph>UID1</codeph> correctly. </p> </li>
<li id="GUID-2FB86A73-A3D3-5289-B5C3-5D3CE68EE68C"><p>Specify the UID for
the DLL in a <codeph>UID</codeph> line: </p> <p><userinput>UID 0x1000008d
&lt;UID3&gt;</userinput> </p> </li>
</ul> </section>
<example><p>An example of the <filepath>mmp</filepath> project file for a
static DLL is given below: </p><codeblock id="GUID-0690A3DC-3FF4-5FA1-9532-7ED2A0E65C1B" xml:space="preserve">TARGET        CreateStaticDLL.dll
TARGETTYPE    dll
UID           0x1000008d 0x10004268
SOURCEPATH    .
SOURCE        CreateStaticDLL.cpp
USERINCLUDE   .
SYSTEMINCLUDE \Epoc32\include
LIBRARY       euser.lib
EXPORTUNFROZEN</codeblock></example>
</conbody></concept>