Article ID: 212884 - Last Review: August 19, 2005 - Revision: 1.2

INFO: How to Use the EmpFile Utility

View products that this article applies to.
This article was previously published under Q212884
Expand all | Collapse all

SUMMARY

Windows CE developers might need to manipulate files that exist in the Windows CE emulation environment. This article describes the EmpFile utility and how to use it to copy, delete, verify the existence of, synchronize, or run emulation files.

NOTE: There is no EmpFile utility for the Pocket PC SDK. To work with files in emulation for these projects, put the files in the following location, which is equivalent to the root directory:
C:\Windows CE Tools\wce300\MS Pocket PC\emulation\palm300

MORE INFORMATION

There is a separate version of the EmpFile utility for each of the Windows CE Platform SDKs. By default, EmpFile exists in the following locations:

Handheld PC Platform SDK:
C:\Windows CE Tools\WCE200\MS HPC\emulation\windows
Handheld PC Pro Platform SDK version 3.0:
C:\Windows CE Tools\WCE211\MS HPC Pro\emulation\hpcpro\windows
Palm-size PC Platform SDK version 1.2:
C:\Windows CE Tools\WCE211\ms palm size pc\emulation\palm211\windows
The following examples illustrate how to use the EmpFile utility. Please note that EmpFile needs to be called by using the appropriate path to the utility.

Command line options: 
   -c SRC_FILESPEC DST_FILESPEC (Copy a file to or from the object store)
   -d WCE_FILESPEC (Delete a file on object store)
   -e WCE_FILESPEC (Check existence of a file in the object store)
   -r WCE_FILESPEC ARGS (Run an application in the object store with
                         arguments ARGS)
   -s (synchronize object store with wce\emul\platform tree)
   /? (Displays a list of EmpFile options and command line examples.
       Note: This launches the emulation shell before displaying the list.)
   /? /noshell (Displays the same list as above without launching the
                emulation shell)
where wce_filespec is of the form: 
   wce:\wce_path (such as wce:\myfile.txt)
When you copy files, either SRC_FILESPEC or DST_FILESPEC must be a WCE_FILESPEC. The DST_FILESPEC must be a path to desktop or emulation. Wild cards are allowed for SRC_FILESPEC only if it is not a WCE_FILESPEC.

Examples:

To copy a file (text.exe) to the emulation object store's \Windows directory, use: 
EMPFILE.EXE -c c:\test.exe wce:windows\test.exe
Please note that when you copy the files over to either the Handheld PC Pro or Palm-size PC emulation environment, the command line is: 
EMPFILE.EXE -c c:\test.exe wce:windows\
To copy a file (text.exe) from the emulation object store's \Windows directory to the c:\ drive, use: 
EMPFILE.EXE -c wce:windows\test.exe c:\test.exe
To delete test.exe from the object store's root directory, use: 
EMPFILE.EXE -d test.exe
To verify that test.exe exists in object store's Windows\ directory, use: 
EMPFILE.EXE -e windows\text.exe
To synchronize the wce\emul\platform\ tree with object store, use: 
EMPFILE.EXE -s
To run test.exe from object store with parameter "-10" use: 
EMPFILE -r test.exe -10
NOTE: "Platform" is the platform selected in the Emulation Settings dialog box. Wildcards are not supported in the Handheld PC Platform SDK version of EmpFile. Specify the fully qualified path name for the Copy command.
APPLIES TO
  • Microsoft Windows CE Toolkit for Visual Basic 6.0
  • Microsoft eMbedded Visual Basic 3.0
Back to the top
Keywords: 
kbinfo kbtoolkit KB212884
 

Get Help Now

Contact a support professional by E-mail, Online, or Phone

Article Translations