HOWTO: Manually Uninstall Visual Basic CE Applications
ID: Q185223
|
The information in this article applies to:
-
Microsoft Windows CE Toolkit for Visual Basic 5.0
-
Microsoft Windows CE Toolkit for Visual Basic 6.0
SUMMARY
This article describes how to manually remove a program created by the
Windows CE Toolkit for Visual Basic (VBCE) from your H/PC or H/PC Pro. To uninstall
a VBCE program, you must remove the files generated by the CE Services
Application Manager, remove any controls registered by the program, and
delete whatever files and folders were added during the installation
process, while avoiding the removal of components or files that are shared
by other applications.
MORE INFORMATION
A VBCE program consists of the following parts:
- The .pvb file for the application (in VBCE 5.0).
- The .vb file for the application (in VBCE 6.0).
- The VBCE run-time files.
- The .dll and data files added for the application.
VBCE programs are usually installed and uninstalled by the CE Services
Application Manager. If, for some reason, the Application Manager fails to
completely install or remove the program, you may manually remove it by
removing all of its files and registry settings.
Cleaning Up Application Manager Files
The Application Manager does the following when installing a program:
- Copies the CAB file to Windows\AppMgr\Install.
- Decompresses and copies the files.
- Creates folders as needed.
- Puts DAT and DLL files in Windows\AppMgr.
- Puts files in the application folder.
- Puts files in the Windows folder (no other folders usually needed).
- Registers controls.
- Creates an Unload file.
- Writes uninstall registry entries.
Using Pocket Word (PWD), you may look at the .unload or .dat files for
clues on what was added during the install process. In most cases, the VBCE
Application Install Wizard instructs the Application Manager to use file
names of the form "CompanyName AppName."
NOTE: The .dat and .unload files are not in Pocket Word or pure text
format. Do not modify the files if they are to be used later.
- If it exists, delete the CAB file for the application. If the
Application Manager runs of out room while copying the CAB file, the
device may drop the connection to the desktop and exhibit other strange
behavior because it is out of working room. To recover, allocate some
application memory for storage using the Memory tab under the System
icon in the Control Panel (reset the device if needed), and delete the
CAB file from the \Windows\AppMgr\Install folder.
- If they exist, delete the .dll and .dat file for the application from
the \Windows\AppMgr folder.
- Delete the program's .lnk file from the \Windows\Programs folder. This will remove the program from the Start menu.
- Delete the application's program folder. Application files are usually
stored in a folder called \Program Files\[appname] where [appname] is
the name of the application (as specified in Step 7 of the Application
Install Wizard).
- Delete the other files (except .dll files) that were installed in the
Windows folder.
NOTE: If you are unsure whether another application requires the file,
it is safer not to delete it.
Cleaning Up Registry Entries
Because Windows CE 2.0 does not ship with a registry editor, you must use a
third-party program, the Toolkit's Remote CE Regedit, or the Control
Manager to manually change registry settings.
- Unregister installed .dll files that are not shared by other
applications. If you are unsure whether a .dll is shared, it is safer to
leave it. To unregister a control run the following:
RegSvr.Exe /u \windows\[controlname]
Where [controlname] is the name of a control such as MSCEFile.dll. You
can use the Windows CE Control Manager to automatically run RegSvr /u on
the device in an attempt to remove controls.
- Due to a bug in RegSvr.exe, controls may not be completely unregistered
and may still show as installed in the Control Manager.
WARNING: Using Registry Editor incorrectly can cause serious problems that
may require you to reinstall your operating system. Microsoft cannot
guarantee that problems resulting from the incorrect use of Registry Editor
can be solved. Use Registry Editor at your own risk.
For information about how to edit the registry, view the "Changing Keys And
Values" Help topic in Registry Editor (Regedit.exe) or the "Add and Delete
Information in the Registry" and "Edit Registry Data" Help topics in
Regedt32.exe. Note that you should back up the registry before you edit it.
If you are running Windows NT, you should also update your Emergency
Repair Disk (ERD).
The registry holds control information in three places: ProgId, CLSID,
and TypeLib.
NOTE: Deleting the CLSID information (in HKey_Classes_Root\CLSID\<key>)
is required to ensure the control is unregistered. Removing the ProgId
and TypeLib information is not required. Partially uninstalled controls
are safe to leave on your system, but will not function properly.
For example, identify the registry entries for the MSCEFile.dll. The
File control actually has two classes: File and File System. This
example focuses only on the File class.
- ProgIds are listed in HKEY_CLASSES_ROOT\:
HKEY_CLASSES_ROOT\FILECTL.FileSystem
HKEY_CLASSES_ROOT\FILECTL.FileSystem.1
(In the Clsid subfolder will be the matching Clsid:
{3F0C2794-5C3A-11D1-A717-00AA0044064C} )
HKEY_CLASSES_ROOT\FILECTL.File
HKEY_CLASSES_ROOT\FILECTL.File.1
(Clsid={25C953B5-5464-11D1-A714-00AA0044064C})
- CLSID information is listed in HKEY_CLASSES_ROOT\CLSID\<clsid>. Use
the CLSID found in step A above to locate the matching entry, such as
the following:
HKEY_CLASSES_ROOT\CLSID\{25C953B5-5464-11D1-A714-00AA0044064C}
Under this key will be numerous entries that provide additional
information about the server, such as: Version, TypeLib,
InProcServer32, and ProgId (useful as a cross reference).
WARNING: DO NOT delete the parent key HKey_Classes_Root\CLSID!
Note the TypeLib value from KEY_CLASSES_ROOT\CLSID\<clsid>\TypeLib. For
the File class is should be: {25C953A7-5464-11D1-A714-00AA0044064C}.
- TypeLib information is listed in HKEY_CLASSES_ROOT\TypeLib\<clsid>.
Use the TypeLib value obtained in step B above to locate the matching
TypeLib key.
HKEY_CLASSES_ROOT\TypeLib\{25C953A7-5464-11D1-A714-00AA0044064C}
- Now that you have found the entries for the class, you can delete the
appropriate CLSID subkey (not the entire KEY_CLASSES_ROOT\CLSID).
Deleting the matching TypeLib and ProgId entries are optional.
- You may delete the .dll file that you just unregistered. To re-register a control that you accidentally unregister, run the
following:
RegSvr.Exe \windows\[controlname]
This is not possible if you delete the control.
- Also in the registry are entries for the Start menu:
HKEY_Local_Machine\Software\Apps\<TOKEN>application name</TOKEN>
This key can be deleted if desired.
Deleting the Visual Basic Run Time
If no other Windows CE Toolkit for Visual Basic 5.0 programs are installed on the H\PC, it might be possible to remove the following files:
- Pvb.exe
- Vbscript.dll
- Pvbrt.dll
- Vbsen.dll
If no other Windows CE Toolkit for Visual Basic 6.0 programs are installed on the H\PC, it might be possible to remove the following files:
- pvbdecl.dll
- pvbform2.dll
- pvbhost2.dll
- pvbload.exe
- vbscript.dll
- vbsen.dll
On some HPCs, these files may be in ROM, making it impossible to delete
them.
WARNING: These files are required to run Visual Basic programs on Windows
CE. If they are deleted, you cannot run other programs created by the
Toolkit until they are restored. Please use caution when removing them.
Follow the steps in this article to remove a VBCE program from the HPC. The
steps do not remove the installation program from the desktop.
NOTE: Development machines may still contain other files used by the remote
tools and the debugger.
REFERENCES
Books Online for Microsoft Windows CE Toolkit for Visual Basic 5.0
Additional query words:
uninstall wince wce vbce vbce5 vbce6
Keywords : kbToolkit kbVBp500 kbVBp600 kbWinCE100 kbGrpVB
Version : WINDOWS:
Platform : WINDOWS
Issue type : kbhowto
|