In this section:

Introduction

This section describes basic Insure++ usage on Windows. Visual Studio must be installed prior to installing Insure++. See Requirements for details.


Video Tutorial for Visual Studio

Creating the Insure++ Configurations

Insure++ is called using a Visual Studio configuration. The following process only needs to be performed once for each project you intend to run with Insure. 

  1. Build the application in Visual Studio.
  2. Open Configuration Manager from the Build menu or toolbar.
  3. Choose <New...> from the Active solutions platform menu. The New Solution Platform dialog opens.
  4. Choose either Insurex64 (for 64-bit applications) or InsureWin32 (for 32-bit applications) from the Type or select the new platform drop-down menu.

  5. If you are creating a new Insurex64 configuration, choose x64 from the Copy settings from menu. If you are creating a new InsureWin32 configuration, choose Win32.

  6. Enable the Create new project platforms option and click OK.

A new configuration that builds the project with Insure will be created. You can either rebuild and run the program using the IDE or on the command line.

Building and Running in the IDE

  1. Choose the Insure++ configuration that you want to use from the standard toolbar and choose Build > Rebuild Solution from the main menu.
  2. Click the start button for the Local Windows Debugger.

Insra will launch and start reporting bugs. See Viewing Results for information about using Insra.

Building and Running on the Command Line

You can build with msbuild or devenv. The syntax is the same for both programs. Open the Visual Studio command prompt (e.g., x64 Native Tools Command Prompt for VS 2019) and run msbuild  or devenv with an Insure++ configuration (see Creating the Insure++ Configurations), e.g.:

MSBuild -property:SolutionConfiguration=Debug/Insurex64 editor_demo_VS150.sln

The project will be built using the Insurex64 configuration, which will instrument the code so that Insure can capture debug information.

Run the executable and Insure will launch. See Viewing Results for information about using Insra.

Running Insure on the Command Line without MSBuild

You can invoke Insure++ instead of CL directly on the command line. See Command Line for additional information.