IVsDebugger.LaunchDebugTargets Method (UInt32, IntPtr)

 

Launches or attaches to the specified processes under the control of the debugger.

Namespace:   Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

int LaunchDebugTargets(
	uint cTargets,
	IntPtr rgDebugTargetInfo
)

Parameters

cTargets
Type: System.UInt32

[in] Number of targets to launch (specifies the number of VsDebugTargetInfo structures pointed to by rgDebugTargetInfo).

rgDebugTargetInfo
Type: System.IntPtr

[in, out] Array of VsDebugTargetInfo structures describing the programs to launch or attach to.

Return Value

Type: System.Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

From vsshell.idl:

HRESULT IVsDebugger::LaunchDebugTargets(
   [in] ULONG cTargets,
   [in, out, size_is(cTargets)] VsDebugTargetInfo *rgDebugTargetInfo
);

This is the method called by the DebugLaunch method to do the launch. This indirection gives DebugLaunch a chance to make changes or additions to the debug launch cycle; for example, adding custom debug engines to launch with the process.

System_CAPS_noteNote

You can find an example implementation of DebugLaunch and how it uses IvsDebugger::LaunchDebugTargets in the sample.cccbaa9b-1d34-4e17-82b2-b4670d6f2577

Return to top
Show: