======================================================================
  Microsoft(R) Product Support Services Application Note (Text File)
          CP0982: MICROSOFT SETUP TOOLKIT FOR VISUAL C++(TM)
======================================================================
                                                  Revision Date: 05/94
                                                       1 Disk Included

The following information applies to Microsoft Visual C++,
versions 1.0, 1.5.

-----------------------------------------------------------------------
| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY     |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an Application |
| Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER      |
| EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED      |
| WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR       |
| PURPOSE. The user assumes the entire risk as to the accuracy and    |
| the use of this Application Note. This Application Note may be      |
| copied and distributed subject to the following conditions:  1) All |
| text must be copied without modification and all pages must be      |
| included;  2) If software is included, all files on the disk(s)     |
| must be copied without modification (the MS-DOS(R)  utility         |
| diskcopy is appropriate for this purpose);  3) All components of    |
| this Application Note must be distributed together;  and  4) This   |
| Application Note may not be distributed for profit.                 |
|                                                                     |
| Copyright (C) 1993-1994 Microsoft Corporation. All Rights Reserved. |
| CodeView, Microsoft, MS-DOS are registered trademarks and Visual    |
| C++  and Windows are trademarks of Microsoft Corporation.           |
|---------------------------------------------------------------------|
  
IMPORTANT: If you do not own Visual C++, you do not have the right to 
use the Microsoft Setup Toolkit contained on this disk. The programs 
on this disk are subject to the same licensing restrictions agreed to 
with your Visual C++ product.
                                   
                                   
                               CONTENTS
                               ========
      
The CP0982 disk included with this Application Note contains a single
file, TOOLKIT.EXE, which self-extracts to the following files:
   
   Filename         Description
----------------------------------------------------------------------
   SETUPB.EXE       Setup Toolkit files
   SETUPD.EXE       Setup Toolkit documentation
   MSSETUP.HLP      Help file containing most common questions about
                    the Setup Toolkit
   COMPRESS.EXE     File-compression utility
                                 
                                   
                             INSTALLATION
                             ============

To install TOOLKIT.EXE, create a directory for the Setup files, such
as:

   c:\setuptk

Copy the TOOLKIT.EXE file to this directory, move into this directory,
and type:

   toolkit.exe

This will give you the files listed above. Place COMPRESS.EXE in your
\MSVC\BIN directory, change to the directory that you created for the
Setup files, and unzip the rest of the files with the following
commands:

   setupb.exe -d
   setupd.exe -d
      
NOTE: -d duplicates the directory structure contained in the zip file.
                                   
                                   
                              FILES LIST
                              ===========

ROOT DIRECTORY
==============

The following are the files composing the Setup program and samples.

Setup Executables
-----------------

...\SETUP.EXE. Do not compress this file. Setup bootstrapper copies
SETUP.EXE, .DLLS, include files, and _MSTEST.EXE from your floppy disk
drive to a temporary directory on the local hard disk drive for
execution. This prevents code-segment discarding or reloading after
the original floppy disk has been swapped out. The list of files to
copy is contained in the SETUP.LST file (see below). The name of the
temporary directory may also be specified in the SETUP.LST file. This
.EXE should not be compressed--it will be run by the enduser when
installing your program. This file must be on Disk 1.

...\SETUP.LST. Do not compress this file. The bootstrapper data file
contains a list of Setup files and other information to copy to the
temporary directory. This file and all files listed in SETUP.LST must
be on Disk 1.

...\_MSTEST.EXE. Limited run-time version of Microsoft Test for
Windows. This is the .EXE that runs the Setup script (the .MST file),
reads data from the .INF file, and makes calls to the MS???STF.DLL
libraries. This file needs to be listed in the SETUP.LST file and must
be on Disk 1.

...\_MSSETUP.EXE. This is a special MS-DOS-only program that is
executed if Windows is restarted. This is used only if files marked as
SYSTEM files need to be updated at Setup time and they are locked by
Windows, thus preventing this operation from succeeding without
restarting Windows. If you have no files marked SYSTEM in your .INF
file, you do not need to ship this file; otherwise, it must be listed
in the SETUP.LST file and must be on Disk 1.

Setup DLLs
----------

These files contain the code for the routines being called in your
Setup script. They are needed by _MSTEST.EXE and must be listed in the
SETUP.LST file and shipped on Disk 1.

Filename            Description
----------------------------------------------------------------------
...\MSCOMSTF.DLL    Common Library DLL
...\MSCUISTF.DLL    Custom UI DLL--This should be customized using the
                    SDK's Dialog Editor and the BLDCUI subdirectory.
...\MSDETSTF.DLL    Detection Routines DLL
...\MSINSSTF.DLL    Install Routines DLL
...\MSSHLSTF.DLL    MS-Setup Shell Library DLL
...\MSUILSTF.DLL    UI--Library DLL

Associated Include Files
------------------------

These files may be included in your SETUP.MST script. If they are,
they must be listed in the SETUP.LST file and shipped on Disk 1.

Filename            Description
----------------------------------------------------------------------
...\SETUPAPI.INC    API definitions include file--Contains prototype
                    declarations for most Setup functions (required)
...\MSDETECT.INC    Detection API include file (optional, but very useful)
...\MSREGDB.INC     Microsoft Windows 3.1 Registration Database Include
                    File (optional)
...\MSSHARED.INC    Microsoft Shared Application Include File (optional)

Sample Files
------------

The following files are setup scripts and related .INF files. Only one
set is necessary. These files must be listed in the SETUP.LST file and
shipped on Disk 1.

Filename            Description
----------------------------------------------------------------------
...\SAMPLE1.MST     Sample setup script for a simple
                    installation
...\SAMPLE1.INF     INF file for use with SAMPLE1.MST
...\SAMPLE2.MST     Sample setup script with a
                    complicated Options Dialog
...\SAMPLE2.INF     INF file for use with SAMPLE2.MST
...\SAMPLE3.MST     Sample setup script for installing
                    shared application files
...\SAMPLE3.INF     INF file for use with SAMPLE3.MST

Help Files
----------

Filename            Description
----------------------------------------------------------------------
...\TESTDRVR.HLP    Windows Help file containing descriptions of the
                    Statements and Intrinsic Functions supplied by
                    Microsoft Test for Windows. (Do not ship)
...\README.WRI      File containing extra information about the
                    product and any last-minute change information.
                    (Do not ship)

THE BLDCUI SUBDIRECTORY
=======================

The following files are needed to build the MSCUISTF.DLL. Do not ship
these--only ship the resulting DLL built from them.

Filename            Description
----------------------------------------------------------------------
...\DIALOGS.DLG     The text file containing the Dialog Templates
                    definitions used in the samples.
...\DIALOGS.H       The Header file containing the Constant
                    declarations used in the Dialogs Template
                    definitions.
...\DIALOGS.RC      The RC file used by the Resource Compiler to
                    create the MSCUISTF.DLL. It includes DIALOGS.DLG
                    and DIALOGS.H.
...\DIALOGS.RES     A version of DIALOGS.RC that has been compiled
                    with the Resource Compiler. This file may be
                    loaded directly into the SDK Dialog Editor.
...\BLDVER.H        Resource include file containing the Version
                    Resource information. It gets included into
                    DIALOGS.RC.
...\DLGPROCS.C      The C-File containing the Dialog Procedure code.
...\CUI.H           C-language header file that contains prototypes
                    for the functions contained in other Microsoft
                    Setup DLLs, used in DLGPROCS.C and described in
                    Chapter 2 of the Microsoft Setup Toolkit manual.
...\SETUP.ICO       The Setup icon file, which can be included in
                    dialog boxes.
...\BITMAP.DIB      The Microsoft Setup logo painted on the background
                    blue screen. You can replace this with a different
                    .DIB file, but it must be white on black.
...\MAKEFILE        A makefile to build the MSCUISTF.DLL using files
                    in this directory. It contains a setting that
                    determines whether a debug or ship version will be
                    built.
...\MSCUISTF.DEF    DEF file for declaring library exports for the
                    dialog procedures defined in DLGPROCS.C
...\CUISTF.LNK      The ship-version link file
...\CUISTFD.LNK     The debug-version link file with CodeView(R)
                    information
...\MSCOMSTF.LIB    Import libraries for APIs in CUI.H
...\MSSHLSTF.LIB    Import libraries for APIs in CUI.H
...\MSUILSTF.LIB    Import libraries for APIs in CUI.H

THE DISKLAY SUBDIRECTORY
=========================

The following files compose the Disk-Layout utility. Do not ship these
files--they are used to generate one or more disk images and
associated .INF files.

Filename            Description
----------------------------------------------------------------------
...\DSKLAYT.EXE     Disk Layout Front-End. This is a Windows and 
                    Visual Basic application that allows you to 
                    specify restrictions and attributes of the files 
                    you will ship with your product.
...\DSKLAYT2.EXE    Disk-Layout Back-End. This is an MS-DOS-based
                    application that uses the information generated by
                    DSKLAYT.EXE and creates compressed versions of your
                    files, with a corresponding disk image of each disk
                    copied to differently named directory.
...\COLORLST.VBX    Visual Basic run-time custom library. Required by
                    DSKLAYT.EXE.
...\VBRUN100.DLL    Visual Basic run-time library. Required by
                    DSKLAYT.EXE.

THE INTLDLL SUBDIRECTORY
========================

Files in the INTLDLL subdirectory are needed to translate the strings
in the DLL resources to localize a product for another country. Do not
ship these files--they are used to generate localized versions of
shipping .DLLs.

Filename            Description
----------------------------------------------------------------------
...\MSCOMSTF.DLL    Linked version of the Common Library that has not
                    had its resources compiled in yet.
...\MSCOMSTF.RC     Uncompiled resource file for the Common Library.
...\MSDETSTF.DLL    Linked version of the Detect Library that has not
                    had its resources compiled in yet.
...\MSDETSTF.RC     Uncompiled resource file for the Detect Library.
...\MSINSSTF.DLL    Linked version of the Install Library that has not
                    had its resources compiled in yet.
...\MSINSSTF.RC     Uncompiled resource file for the Install Library.
...\MSSHLSTF.DLL    Linked version of the Shell (Frame) Library that
                    hasn't had its resources compiled in yet.
...\MSSHLSTF.RC     Uncompiled resource file for the Shell (Frame)
                    Library.
...\MSUILSTF.DLL    Linked version of the UI Library which has not had
                    its resources compiled in yet.
...\MSUILSTF.RC     Uncompiled resource file for the UI Library.
...\GAUGE.DLG       Copy Files Progress Indicator dialog template used
                    in MSINSSTF.RC.
...\BLDVER.H        Resource include file containing the Version
                    Resource information. It gets included each
                    resource file. This is the same file as in BLDCUI.
...\GAUGE.H         Include file.
...\IDS.H           Include file.
...\IDS_INST.H      Include file.
...\LOGIDS.H        Include file.

