Microsoft KB Archive/114563

{|
 * width="100%"|

-

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)

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

--- 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.
 * 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.           |
 * C++ and Windows are trademarks of Microsoft Corporation.           |

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.

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       :
 * }