Copyright: Visual C++ Setup Help
Citation: Copyright 1992-1995 Microsoft Corporation


Welcome

This Setup program helps you install Visual C++ 4.0 and the Microsoft Developer Studio on your computer. You can use Setup for either a completely new installation or to upgrade an existing installation. If you are upgrading an installation, Setup copies only files that are new or updated during the installation process. (Consequently, installing an upgrade is lot faster than a completely new installation.) Additionally, Setup allows you to tailor the installation to your needs with a variety of custom installation options. Once you have installed Visual C++, you may run Setup additional times to install libraries, programs, help files or other components you did not install earlier.

Getting Help

Help is available for most of the dialog boxes displayed during installation. You can either press F1 or the Help button (if one is displayed).

Continuing Setup

To continue running Setup, select Next, Yes, or OK, depending on the dialog box displayed. If you want to review or change information you have entered during the process, you can use the Back button to move backwards in the dialog boxes.

Cancelling Setup

You may cancel setup at anytime by selecting Cancel or by pressing ESC. (The exception to this rule is the Change Directory dialog box, which uses Exit to stop Setup.) Setup will display a message box to verify that you want to stop the Setup program and no files will be copied to your hard drive.


Registration

Use this dialog box to enter your:

•	Name - up to 52 alphanumeric characters

•	Organization (or company) name - up to 52 alphanumeric characters

•	Product ID number - a 10 digit number (printed on a sticker fastened to the jewel case that contained your Visual C++ 4.0 CD-ROM.)

This information will be displayed in the “About” box (found under the Help menu) once Visual C++ is installed.

Once you have completed the fields in the Registration dialog box, pressing Next displays the Registration Confirmation dialog box.

Note   The User Name and Product ID number are required entries. The Organization name is optional.

Registration Confirmation

The Registration Confirmation dialog box allows you to review and confirm the information you entered in the Registration dialog box. If this information is correct, press Yes to continue Setup. If you want to make changes or corrections, press No. Setup returns you to the Registration dialog box.

Note   Once you have successfully run Setup, the registration information is added to your Windows registry. The only way to change this information is to uninstall Visual C++ and reinstall.


Installation Options

Use this dialog box to select the type of installation you want. This dialog box also has a Directory button in the upper right-hand corner that allows you to access the dialog box for changing the directory to which you want the files installed.

The type of installation you choose depends on a number of factors, including the amount of space available on your computer’s hard drive, desired speed of access to Visual C++ components, and whether you are running Setup for a first-time installation or to add components not previously installed. The name of and the space available in the installation root drive and directory are displayed beneath the installation choices.

Tip   For a detailed summary of what the different setup options install on your hard drive and the space required, check the Visual C++ 4.0 footprint table.

Once you have indicated the directory for installation and selected the installation type, click the Next button. Setup displays a message box to verify you are ready to begin the installation. (Unless you have selected Custom, in which case Setup displays the Custom Options dialog box to allow you to customize your installation.) Click Next again to begin copying files to your hard drive.

You can install Visual C++ in one of four ways:

Typical

Minimum

CD-ROM

Custom

Typical Installation

Select Typical to install all the tools and libraries needed to develop 32-bit applications. These include:

•	Microsoft Developer Studio

•	Build tools

•	Static and shared runtime libraries

•	Static and shared Microsoft Foundation class libraries

•	A set of database drivers

•	Tracer and Spy++ tools

Note   A Typical installation does not include Books Online. However, the index files associated with Books Online (the .idx and .kwd files) are copied to your hard drive. This allows quick access to topics and keywords, even though the bulk of the documentation set remains on the CD. Context-sensitive application help files (those which furnish F1 help for the development environment) are copied to the hard drive.

Tip   If you want to see exactly what Typical installs, select the Custom installation option. A Custom installation begins as a Typical installation, so all of the items checked are what is installed when you select Typical.

Minimum Installation

Select Minimum to install only the development environment, Microsoft Foundation Class Library files, compiler, libraries, tools, and the Product Support Services help file (PSS.HLP).

CD-ROM Installation

Select CD-ROM to install only the development environment on your hard disk. After installation, all of the other components are run from the CD-ROM.

Custom Installation

Select Custom to open the Custom Options dialog box and specify the components you want to install. (The items shown as already selected are the items a Typical installation would install.) You should also use this option if you are running Setup to add components to your current installation. The disk space required for this installation depends on the components selected.

Change Directory Button

Select this button to change the installation directory for Visual C++.


Change Directory

Use this dialog box to change the installation directory for Visual C++ from the default of C:\MSDEV to a directory that you designate. Once you have made any desired changes, choose OK to save them and return to the Installation Options dialog box. Choose Cancel if you do not want to save changes made in this dialog box; choose Exit to stop the Setup program. A message box will be displayed that allows you to stop Setup; no files are copied

Install Directory

Use this text box to change the root directory of your installation of Visual C++. If the directory does not already exist, Setup will create it for you.

System Files

This field displays the directory where Setup will install system files, such as MFC, ODBC, and C run-time DLLs.

Note   You cannot change the entries in this field.

Disk Browser

The Disk Browser displays the disk space information for the drive displayed in the Drive box. This feature allows you to quickly scan all available drives for disk space. It does not change your installation drive. You must change the drive by changing the entry in the Install Directory text box.


Custom Options

Selecting Custom in the Installation Options dialog box and clicking Next displays the Custom Options dialog box, which lists a group of options you may choose to install. A description of each option is displayed as it is selected. If an option has no suboptions, the Details button displayed beneath its description is greyed. The Microsoft Developer Studio option, for example, has no other associated options.

However, if a selected option has options of its own, the Details button will become active. Clicking the Details button or double-clicking the option will display additional dialog boxes with lists of options and their accompanying descriptions.

Note   The check boxes in the Custom Options dialog box can exhibit one of three states:

•	All (black check mark) - indicates that the option (and all suboptions) are selected for installation.

•	Some (greyed check box and check mark) - indicates that not all of the option’s suboptions are selected for installation.

•	None (no check mark) - indicates the option (and any suboptions) are not selected for installation.

For example, if you look at Runtime Libraries in the Options list, you will see that its checkbox and checkmark are greyed. If you select Runtime Libraries, the Details button becomes active. Clicking Details brings up the next dialog box, which lists four library choices, only two of which (Static Library and Shared Library) are selected. If you select Static Library from that list, the Details button is again activated. Clicking Details displays a dialog box listing the available static library options.

To dismiss the respective dialog boxes after selecting or deselecting choices, click OK. Once you have reached the main Custom Options dialog box, click Next to continue the installation.

Resetting a Custom Installation

If for any reason you want to reset the custom options to the default Typical settings, use the Back button to return to the Installation Options dialog box and select Typical.


Using Setup Ccommand-Line Switches
Using Setup Command-Line Switches

The Setup program includes a number of command-line switches that you may use if you run Setup either from the DOS prompt or from Run in Windows 95 or File | Run in Windows NT File Manager. These provide the following options:

/F	does not copy files to the hard drive, but sets up directories, registry entires, and creates a program group. There are two reasons you might want to use this option:

•	Setup ended abnormally after all the files were copied, but before configuration changes were made to your system. You could rerun Setup /F to update the configuration.

•	For NT users who have multiple accounts or machines used by multiple users, Setup can be rerun with /F to customize configuration information and program groups for each account or user.

/L	creates a log file of the files Setup copies to the user’s hard drive. This file is created as \msdev\msvc-stp.log, and contains a list of the files Setup proposed to copy, then a list of the files that were actually copied. It does not list the files that were copied by the setups for ODBC and DAO.

/O	copies files without changing the current system configurations.

/P	copies a typical installation but does not update the program mangers, icons, group, etc.


Uninstalling Visual C++

Visual C++ can be uninstalled using either the Windows 95 Control Panel Add/Remove Programs application or, on Windows NT, using an Uninstall icon placed in the Microsoft Visual C++ 4.0 program manager group.

Here is what the Uninstall program does. It:

•	Removes all Visual C++ installed files that are not located in the Windows system directory except those project files created by users (for example, new projects you have created in \MSDEV.)

Note   Microsoft Developer Studio (\MSDEV) may also contain files that are shared by other products using this common shell. Uninstall will remove these files as outlined below.

•	For files located in the Windows system directory that may be shared by other applications, Uninstall gives the user three prompted options:

•	Yes - remove file.

•	Yes to all - removes all files, including those shared by other applications. If you select “Yes to all” you will not see any further prompts. Use this selection with caution.

•	No - do not remove the file.

•	No to all - do not remove any shared files. If you select “No to all” you will not see any further prompts relating to shared files and no shared files will be deleted.

•	Deletes the "Developer" registry if no other products using common elements of Microsoft Developer Studio remain.

•	Deletes the "Microsoft Visual C++ 4.0" program manager group.

Note   If the user has created Visual C++ 4.0 project files that are not uninstalled, Uninstall will remove the Developer registry entry and the program manager group. However, it will not remove the user-created files, or their respective subdirectories and root directory.

To uninstall VC++:

•	For Windows 95 installation, locate Microsoft Visual C++ 4.0 in the "Add/Remove Programs" control panel application and press "Remove" button.

– or –

•	For Windows NT installations, double-click the Uninstall icon in the Microsoft Visual C++ 4.0 program manager group.


Troubleshooting Your Installation

If Visual C++ does not install or run as expected, consult the Troubleshooting section of the Product Support Services help file (PSS.HLP), which can be found on the Visual C++ 4.0 CD-ROM under \MSDEV\HELP or accessed from the Microsoft Developer Studio Help menu. If you cannot determine the cause of the problems yourself and want help from Microsoft Product Support Services, PSS.HLP also lists the phone numbers for product support.


Visual C++ 4.0 Footprint

Table 1   Visual C++ 4.0 Footprint

Type of install	Install size \msdev	Install size \system	What you get on your hard drive	What’s not on your hard drive
Minimal	70 MB	18 MB	Microsoft Developer Build tools CRT Shared libraries  (Retail + Debug) CRT Single Threaded Static library  (Retail) MFC Shared libraries (Retail +  Debug) Tools: MFC Tracer	What’s missing in Typical Install +  Will need CD-ROM to step into MFC sources Will need CD-ROM to link in  MFC  Statically No OLE controls copied No Data Access support No SDK tools
Typical	110 MB	20 MB	Minimal Install +OLE Controls CRT Multi-Threaded Static Libraries (Retail + Debug) CRT Single Threaded Static library (Debug) MFC Static libraries (Retail + Debug) MFC Source Code ODBC Drivers:- Dbase, FoxPro, Access, SQL DAO Tools: Spy ++ , CDK tools, Win32 tools	Will need CD-ROM for Books-Online Will need CD-ROM to step into CRT source code Will need CD-ROM for MFC Unicode support Will need to run Custom install for the Profiler
Complete	240 MB	20 MB	Typical Install + CRT Source CodeMFC Static Unicode Libraries MFC Shared Unicode Libraries ODBC Drivers: Text,  Paradox  and Excel Drivers Tools: Profiler  Books Online	Need CD-ROM for Samples or can Tree copy Samples
CD-ROM	23 MB	5 MB	All files that go to the system directory except PDB’s A subset of the IDE files	You get the whole product ( CD-ROM a must)
Note   All disk space usage figures are approximate and may vary slightly depending on your installation.