Regmerge.dll; Copyfile - Symbol PPT 8800 Product Reference Manual

PPT 8800 with Windows Mobile 2003 Software for Pocket PCs Product Reference Guide
Windows CE expects certain files to be in the Windows folder, residing in volatile storage.
Windows CE maintains the System Registry in volatile storage. There are two device
drivers included in the Windows CE image to assist developers in configuring the terminal
following a hard reset: RegMerge and CopyFile.

RegMerge.dll

RegMerge.dll is a built-in driver that allows registry edits to be made to the Windows CE
Registry. Regmerge.dll runs very early in the boot process and looks for registry files (.reg
files) in certain Flash File System folders during a hard reset. It then merges the registry
changes that are in these files into the system registry located in RAM.
Since the registry is re-created on every hard reset from the default ROM image, the
RegMerge driver is necessary to make registry modifications persistent over hard resets.
RegMerge is configured to look in three specific folders for .reg files in the following order:
\Platform
\Application
Regmerge continues to look for .reg files in these folders until all folders are checked. This
allows folders later in the list to override folders earlier in the list. This way, it is possible to
override Registry changes made by the Platforms partitions folders. Take care when using
Regmerge to make Registry changes. The SMDK contains examples of .reg files.
Note: Regmerge only merges the .reg files on hard resets. The merge
process is skipped during a soft reset.
Typically, you should not need to make modifications to registry values for drivers loaded
before RegMerge. However, sometimes during software development, you may need to
modify these values. Since these early loading drivers read these keys before RegMerge
gets a chance to change them, you must soft reset the terminal after a hard reset. The soft
reset does not re-initialize the registry, and the early loading driver reads the new registry
values.
Do not use Regmerge to modify built-in driver registry values, or merge the same Registry
value to two files in the same folder, as the results are undefined.

CopyFile

CopyFile copies files from one folder to another on a hard reset. Files can be copied from
a non-volatile partition (Application or Platform) to the Windows or other volatile partition
9-22