This topic has not yet been rated - Rate this topic

IVsDebugger.LaunchDebugTargets Method

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.

COM Signature

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.

NoteNote

You can find an example implementation of DebugLaunch and how it uses IvsDebugger::LaunchDebugTargets in the My C Package sample.

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ