Root Statement (Compact 2013)

3/26/2014

This statement defines the root directories for the run-time image.

Syntax

root:[-Directory("dir_name")] [-Permdir("dir_name")] 
[-File("target_filename", "source_location")]

root:
This parameter specifies the root directory for the Windows Embedded Compact OS.

-Permdir(" dir_name")
This parameter defines a permanent directory that a user cannot remove with the RemoveDirectory API.

This parameter can be used instead of the -Directory parameter. If a removal is attempted, an ERROR_ACCESS_DENIED message is returned.

-File(" target_filename", " source_location")
This parameter defines a target file name and source location in the specified directory. It is used to copy files from ROM, as defined by the Windows directory, to any directory created by the Directory statement.

This parameter can have the following values:
- target_filename
  This value specifies the target file name as it should appear on the device when it boots.
- source_location
  This value specifies the path and file name of the file as it is stored in ROM before the device boots. All files in ROM are located in the \Windows directory.

The following example shows how the root statement is used to create the following directories.

\My Documents\

\Program Files\

root:-Directory("My Documents")
root:-Directory("Program Files")

The final Initobj.dat file created from all .DAT files must contain a root: keyword as its first entry.