IVsDebugger.LaunchDebugTargets(UInt32, IntPtr) Method

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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

public:
 int LaunchDebugTargets(System::UInt32 cTargets, IntPtr rgDebugTargetInfo);

public int LaunchDebugTargets (uint cTargets, IntPtr rgDebugTargetInfo);

abstract member LaunchDebugTargets : uint32 * nativeint -> int

Public Function LaunchDebugTargets (cTargets As UInteger, rgDebugTargetInfo As IntPtr) As Integer

Parameters

cTargets

UInt32

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

rgDebugTargetInfo

IntPtr

nativeint

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

Returns

Int32

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

Remarks

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.

Note

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