DOCUMENT:Q190150  07-AUG-1998  [vbwin]
TITLE   :HOWTO: Force Application Setup to Use the Default Directory
PRODUCT :Microsoft Visual Basic for Windows
PROD/VER:WINDOWS:4.0,5.0,6.0
OPER/SYS:WINDOWS
KEYWORDS:

======================================================================
---------------------------------------------------------------------
The information in this article applies to:

 - Microsoft Visual Basic Professional and Enterprise Editions for
   Windows, versions 4.0, 5.0, 6.0
---------------------------------------------------------------------

SUMMARY
=======

Although it is not recommended, the Visual Basic Setup Toolkit provides a
means to disable the user interface for changing the default installation
directory of your application's setup routine. This forces the installation
process to use the default directory as the destination for the
application's files.

MORE INFORMATION
================


It is recommended that you allow the user to choose the destination
directory for Windows applications setup processes. However, a Visual Basic
application that has a setup program created by the Visual Basic Setup
Wizard on Visual Basic versions 4.0 and 5.0 or the Package and Deployment
Wizard (PDW) on Visual Basic 6.0 does provide an option that allows the
programmer to force the user to use a specific destination directory.

The Setup.lst file is a standard Windows initialization file. It informs
the Setup.exe and Setup1.exe programs of the distribution set how to
perform setup. To force a user to use a specific destination directory, you
must provide the default directory name and add the keyword
"ForceUseDefDir" to the Setup.lst file.

Step-by-Step Example
--------------------

1. Run the Application Setup Wizard or PDW to create a distribution set for
   your application.

2. Open the Setup.lst file (found on disk #1 of the distribution set) in a
   text editor, such as Notepad.

3. Specify the default installation directory by modifying the "DefaultDir"
   key in the "Setup" section of the Setup.lst file. For example:

      DefaultDir=C:\MyProgramDir

4. Insert the following line immediately after the "DefaultDir" line:

      ForceUseDefDir=1

5. Save the Setup.lst file. Note that the Setup Wizard makes maximum usage
   of each disk. If you cannot save the file due to insufficient space on
   the diskette, delete one or more of the
   "; XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" lines
   at the bottom of the Setup.lst file.

Additional query words: kbDSupport kbAppSetup kbVBp400 kbVBp500 kbdss
kbVBp600
======================================================================
Version           : WINDOWS:4.0,5.0,6.0
Platform          : WINDOWS
Issue type        : kbhowto

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS
PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.  MICROSOFT DISCLAIMS
ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  IN NO
EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR
ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL,
CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF
MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.  SOME STATES DO NOT ALLOW THE EXCLUSION
OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES
SO THE FOREGOING LIMITATION MAY NOT APPLY.

Copyright Microsoft Corporation 1998.