Miscellaneous Environment Variables (Windows Embedded CE 6.0)


The following table contains miscellaneous environment variables.

Environment variable Description


Used by Build.exe in the IDE.

Specifies the number of processes launched simultaneously when running a build. This number can be more or less than the number of processors on the development workstation.

The default setting is 1.

It might take several trials to determine the optimal setting for your development workstation, which depends on factors including the number of processors, amount of RAM, and disk performance.

The optimal setting decreases the amount of time Platform Builder requires to complete a build. A setting larger than the optimal one can increase the amount of time required.

The Build.exe command-line argument -M overrides BUILD_MULTIPROCESSOR if the environment variable is set. For more information, see Build Tool.

If you set this environment variable, for more information on synchronizing running build processes, see SYNCHRONIZE_BLOCK and SYNCHRONIZE_DRAIN.


Used by BuildRel.bat when copying files into the flat release directory. By default, BuildRel.bat uses copylink to copy files. If you experience a sharing violation during the copy phase, you can set BUILDREL_USE_COPY=1 to instruct BuildRel.bat to use xcopy.


Specifies that Build.exe treats warnings as errors. This includes instances such as passing an invalid parameter to Build.exe, and parsing warnings when reading sources and dirs files.

When BUILDWARNISERROR is set to 1 in a sources or Sources.cmn file, Build.exe exits after a warning is generated.

You can choose to set this environment variable globally in a Sources.cmn file, and unset it locally in a sources file.


Set to L

Specifies the Handheld PC (H/PC)–style Control Panel.

Set to P

Specifies the Windows Mobile PDA–style Control Panel.

For more information, see Using Applications in Landscape and Portrait Modes.


Used by Makeimg.exe. Defines the target locale for localizing the build environment.

For more information about setting the LOCALE environment variable; see OS Localization.


Defines the combination of BSP and debug or release settings for the current build.


Specifies that output from Romimage is limited to a list of errors and the completion list.

To limit the output from Romimage on the Build tab of the output window; set RI_SUPPRESS_INFO to all.


Defines the CPU family for a BSP.


Defines the name of the BSP.


Specifies whether debugging information is generated in object files.

This environment variable is case sensitive.

Set to "retail"

Does not generate debugging information in object files; object files are placed in the Release directory.

Because this setting allows compiler optimization, using the debugger is not recommended. The debugger could highlight the wrong source line if the compiler rearranges code.

This is the default setting.

Set to "debug"

Generates debugging information in object files; object files are placed in the Debug directory.

Compiler optimizations are also disabled.


Used by Makeimg.exe.


Releases the built components into the %_FLATRELEASEDIR% directory and into the Public directory.

When you have a build set up, you can make incremental changes, rebuild a component, and make a new run-time image without rerunning the Build Release Directory tool, Buildrel.bat.

Microsoft recommends this setting.

Not set

Releases the built components only into the Public directory.

This is the default setting.


Specifies whether this build is for shipping or testing. This is only available in release configurations, and is hidden in debug configurations.


The OS does not generate debug messages. Defines the compile time flag -DSHIP_BUILD, so it can be used to conditionally compile code.

Not set

The OS generates verbose debug messages to aid final testing.


Defines the OS version.

For Windows Embedded CE 6.0, the default value is 600.

You can use this environment variable to specify the OS version that is set in wince.bat. For more information, see Custom Build.

The following table contains miscellaneous environment variables that you can use to specify directory paths. Many of these are set up in Wince.bat.

Environment variable Description


Defines the root directory.

If you have enough space on a single partition, create a root directory on that partition, such as C:\WINCE500, and install the OS under it.

To do this, set %_WINCEROOT% to the full root directory path.


Defines the directory where the released source code and binary files will be placed.

The default is %_WINCEROOT%\OSDesigns\%_TGTPROJ%\RelDir\%_TGTPLAT%\%_TGTCPUFAMILY%_Release.


Defines the location of the current Platform Builder workspace.

The default is %_WINCEROOT%\OSDesigns\%_TGTPROJ%.

However; if you have placed your root directory in a location other than the default; that location is used as the definition for %PBWORKSPACEROOT%.


Defines the location of the Platform directory.

The default is %_WINCEROOT%\Platform..


Defines the location of an alternate root directory, such as a directory to contain a different Set Environment Variable tool, Setenv.bat.

You can set this variable to point to a directory of your choice.

The default is %_WINCEROOT%\Private.


Defines the location of the Oak directory for your project.

During the build process; Build.exe places the files it builds in this directory.

The default is %_PROJECTROOT%\Oak.


Defines the location of the project you are building; for example, %_PBWORKSPACEROOT%\WINCE500\%PBCONFIG%.


Defines the location of public projects.

The default is %_WINCEROOT%\Public.


Defines the location of the tools you use to build projects, such as the command-line compiler, linker, debugger, and run-time libraries.

The default is %_WINCEROOT%\SDK.


Defines the name of the current active workspace.


Specifies whether you are working in a build environment opened from the IDE.

If this is set, the build environment was launched from the IDE. Otherwise, this is not present in Setenv.bat.

For more information, see Using the Set Environment Variable Tool.

See Also


Environment Variables
BSP Environment Variables
BSP_NO Environment Variables
PRJ Environment Variables
IMG Environment Variables