<?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-64D62DD8-3D9C-4659-9658-C0B4D74D6E69" xml:lang="en"><title>Writing

the Version 2 Registration Resource File</title><shortdesc>Writing a version 2 registration resource file is similar to writing

a standard registration resource file.  </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<context>       <p>All the variables required to write a standard registration

resource file must be set. In addition:  </p>     </context>

<steps-unordered>

<step id="GUID-7F2A2305-31F5-431E-8DB5-467859CF5814"><cmd>Set<codeph> resource_format_version</codeph> to

the value of <codeph>RESOURCE_FORMAT_VERSION_2</codeph> defined in <filepath>RegistryInfoV2.rh</filepath>.

 </cmd>

</step>

<step id="GUID-28395805-0EBC-4A16-9AD5-FE88F412EE5C"><cmd>In the <codeph>IMPLEMENTATION_INFO</codeph> resource

that declares the properties of a single implementation, set an additional

member <codeph>rom_only</codeph>.  </cmd>

<info><p><codeph>rom_only</codeph> set to 1 indicates the ROM-only implementation

must be used.  </p><p><codeph>rom_only</codeph> set to 0 indicates the ROM-only

implementation can be overidden.  </p><note> <codeph>rom_only</codeph> value

must be set individually for all implementations declared in a version 2 registration

resource file. </note></info>

<info><p>A RAM plug-in can also use a version 2 registration resource file.

However, the implementation must set <codeph>rom_onlymember</codeph> to 0.

In case it is set to one the plug-in cannot be used.   </p></info>

</step>

</steps-unordered>

<example><p>The following example gives a resource registration file for an

implementation collection with two implementations. The first implementation

cannot be overridden by a RAM-based plug-in and the second can be overridden

by a RAM-based plug-in.</p><codeblock xml:space="preserve">// 10009DB1.RSS

//

#include "RegistryInfoV2.rh"

RESOURCE REGISTRY_INFO theInfo

{

// resource_format_version must always be set as follows

resource_format_version = RESOURCE_FORMAT_VERSION_2;

// Normal plug-in parameters

dll_uid = 0x10009DB5;

interfaces = 

	{

	INTERFACE_INFO

		{

		interface_uid = 0x10009DC9;

		implementations = 

			{

			IMPLEMENTATION_INFO

				{

				implementation_uid = 0x10009DCA;

				version_no = 1;

				display_name = "Example Implementation - ROM-only ";

				default_data = "text/wml";

				opaque_data = "";

				// This implementation CANNOT be overridden by a RAM-based plug-in

				rom_only = 1;

				},

			IMPLEMENTATION_INFO

				{

				implementation_uid = 0x10009DCB;

				version_no = 1;

				display_name = "Example Implementation - not ROM-only ";

				default_data = "text/wml";

				opaque_data = "";

				// This implementation CAN be overridden by a RAM-based plug-in

				rom_only = 0;

				}

			};

		}

	};

}</codeblock></example>

</taskbody><related-links>

<link href="GUID-B541BD01-29BE-4CB7-9420-ABEE0BDC9BA4.dita"><linktext>Writing a

Standard Registration Resource File</linktext></link>

<link href="GUID-39186342-960A-46A4-BC35-851F53665FA8.dita"><linktext>Writing the

Version 3 Registration Resource File</linktext></link>

</related-links></task>