Microsoft KB Archive/212884

= INFO: How to Use the EmpFile Utility =

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

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.