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-914DD950-4332-5F23-B725-F4D330DB19EB" xml:lang="en"><title>UID2

    13 and UID3 statements</title><prolog><metadata><keywords/></metadata></prolog><conbody>

    14 <codeblock xml:space="preserve">&lt;uid2-statement&gt;

    15 uid2-statement ::= 

    16 UID2 <uid-value> <uid3-statement>

    17 uid3-statement ::= 

    18 UID3 &lt;uid-value&gt;</codeblock>

    19 <p>Defines the second (<codeph>UID2</codeph>) and third (<codeph>UID3</codeph>)

    20 UIDs for the resource file. The <varname>uid-value</varname> is a UID number

    21 (or macro representing such a number).</p>

    22 <p>At the start of a resource file, a UID triplet is stored. The first UID

    23 of a resource file is always <codeph>0x101f4a6b</codeph>. By default, the

    24 second UID is zero and the third UID is the resource file’s “offset”, i.e.

    25 the twenty-bit integer generated from the resource file’s name. The defaults

    26 can be overriden using these statements (or from a <codeph>START         RESOURCE</codeph> statement

    27 in an mmp file).</p>

    28 <p>Some clients of resource files read the UID values (see <xref href="GUID-AA6DEF11-6F23-3523-A9F7-F15DF918E1BA.dita#GUID-AA6DEF11-6F23-3523-A9F7-F15DF918E1BA/GUID-142C2031-3101-34E0-8A16-5410123C8D18"><apiname>RResourceFile::UidType()</apiname></xref>)

    29 to test that a resource file is of a suitable type. In many other cases, the

    30 reader of the resource file does not use the UID values, so there is no need

    31 to use the <codeph>UID2/UID3</codeph> statements.</p>

    32 <example><codeblock id="GUID-8B72E4F7-DD19-5BF7-A170-53388CF6BBF1" xml:space="preserve">UID2 KUidAppRegistrationResourceFile

    33 UID3 0x10001234</codeblock></example>

    34 </conbody></concept>