INFO: VBCE: How to Use the EmpFile Utility

ID: Q212884

The information in this article applies to:

Microsoft Windows CE Toolkit for Visual Basic 5.0, version 1.0
Microsoft Windows CE Toolkit for Visual Basic 6.0, version 1.0

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.

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 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 (e.g. wce:\myfile.txt)

When copying 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:


   EMPFILE.EXE -c c:\test.exe wce:windows\test.exe

To copy a file (text.exe) from the emulation object store's \Windows directory to the c:\ drive:


   EMPFILE.EXE -c wce:windows\test.exe c:\test.exe

To delete test.exe from the object store's root directory:


   EMPFILE.EXE -d test.exe

To verify that test.exe exists in object store's Windows\ directory:


   EMPFILE.EXE -e windows\text.exe

To synchronize the wce\emul\platform\ tree with object store:


   EMPFILE.EXE -s

To run test.exe from object store with parameter "-10" :


   EMPFILE -r test.exe -10

NOTE: "Platform" is the platform selected in the Emulation Settings Dialog. 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:

Keywords : kbToolkit kbVBp kbVBp500 kbVBp600 kbWinCE
Version : WINDOWS:1.0
Platform : WINDOWS
Issue type : kbinfo