# INFO: Microsoft Setup Toolkit for Visual C++

ID: Q114563

The information in this article applies to:

- Microsoft Visual C++ for Windows, 16-bit edition, versions 1.0, 1.5

## SUMMARY

    ======================================================================
      Microsoft(R) Product Support Services Application Note (Text File)
              CP0982: MICROSOFT SETUP TOOLKIT FOR VISUAL C++(TM)
    ======================================================================

    -----------------------------------------------------------------------
    | 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.

## MORE INFORMATION

The following file is available for download from the Microsoft Software Library:

> ~ CP0982.EXE

For more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base:

> Q119591 How to Obtain Microsoft Support Files from Online Services

## 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.

Additional query words: kbfile setup toolkit

    Keywords          : kbreadme kb16bitonly TlsMisc
    Version           : 1.00 1.50
    Platform          : WINDOWS
    Issue type        :

Last Reviewed: July 21, 1999 © 1999 Microsoft Corporation. All rights reserved. Terms of Use.