Miscellaneous Environment Variables
The following table contains miscellaneous environment variables.
| Environment variable | Description |
|---|---|
| CPLMAIN_LP | Set to L:
Specifies the Handheld PC (H/PC)–style Control Panel. Set to P: Specifies the Pocket PC–style Control Panel. |
| _FLATRELEASEDIR | Defines the directory where the released project source code and binary files will be placed.
The default is %_WINCEROOT%\Public\%_TGTPROJ%\RelDir\%_TGTPLAT%Debug. |
| LOCALE | Used by Makeimg.exe. Defines the target locale for localizing the build environment.
For more information on setting the LOCALE environment variable, see Platform Localization. |
| _PRIVATEROOT | 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. |
| _PROJECTOAKROOT | Defines the location of the Oak directory for your project.
During the build process, Build.exe places the files that it builds in this directory. The default is %_PROJECTROOT%\Oak. |
| _PROJECTROOT | Defines the location of the project you are building; for example, %_WINCEROOT%\Public\MyProject. |
| _PUBLICROOT | Defines the location of public projects.
The default is %_WINCEROOT%\Public. |
| _SDKROOT | Defines the location of the tools that you use to build the projects, such as the command-line compiler, linker, debugger, and run-time libraries.
The default is %_WINCEROOT%\SDK. |
| _TGTCPUVARIANT | Set to XSC:
Optimizes MP3 codec decoding for XScale-based platforms. |
| _TGTPROJ | Defines the name of the current active workspace. |
| WINCEDEBUG | 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 any code. This setting is the default. Set to Debug: Generates debugging information in object files; object files are placed in the Debug directory. Compiler optimizations are also disabled. |
| WINCEREL | Used by Makeimg.exe.
Set: 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 OS 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. |
| _WINCEROOT | 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. |
See Also
Last updated on Friday, October 08, 2004
© 1992-2003 Microsoft Corporation. All rights reserved.