Article ID: 212884
Article Last Modified on 8/19/2005
APPLIES TO
- Microsoft Windows CE Toolkit for Visual Basic 6.0
- Microsoft eMbedded Visual Basic 3.0
This article was previously published under Q212884
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.
Additional query words: eVB vbce vbce6 tdb
Keywords: kbinfo kbtoolkit KB212884
