IDebugEngineLaunch2

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Used by a debug engine (DE) to launch and terminate programs.

Syntax

IDebugEngineLaunch2 : IDebugEngine2

Notes for Implementers

This interface is implemented by a custom DE if it has special requirements for launching a process that cannot be handled entirely by a custom port. This is typically the case when the DE is part of an interpreter and the process being debugged is a script: the interpreter needs to be launched first, and then the script is loaded and started. A port can launch the interpreter, but the script may require special handling (which is where the DE has a role). This interface is implemented only if there are unique requirements for launching a program that a custom port cannot handle.

Notes for Callers

This interface is called by the session debug manager (SDM) if the SDM can get this interface from the IDebugEngine2 interface (using QueryInterface). If this interface can be obtained, the SDM knows that the DE has special requirements and calls this interface to launch the program instead of having the port launch it.

Methods in Vtable Order

The following table shows the methods of IDebugEngineLaunch2.

Method Description
LaunchSuspended Launches a process by means of the DE.
ResumeProcess Resumes process execution.
CanTerminateProcess Determines if a process can be terminated.
TerminateProcess Terminates a process.

Requirements

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See also