Partilhar via


IDebugEngineLaunch2

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

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

IDebugEngineLaunch2::LaunchSuspended

Launches a process by means of the DE.

IDebugEngineLaunch2::ResumeProcess

Resumes process execution.

IDebugEngineLaunch2::CanTerminateProcess

Determines if a process can be terminated.

IDebugEngineLaunch2::TerminateProcess

Terminates a process.

Requirements

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugEngine2