IVsDebugger.LaunchDebugTargets Method

  • Article

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)

Syntax

'Declaration
Function LaunchDebugTargets ( _
    cTargets As UInteger, _
    rgDebugTargetInfo As IntPtr _
) As Integer

int LaunchDebugTargets(
    uint cTargets,
    IntPtr rgDebugTargetInfo
)

int LaunchDebugTargets(
    [InAttribute] unsigned int cTargets, 
    [InAttribute] IntPtr rgDebugTargetInfo
)

abstract LaunchDebugTargets : 
        cTargets:uint32 * 
        rgDebugTargetInfo:IntPtr -> int

function LaunchDebugTargets(
    cTargets : uint, 
    rgDebugTargetInfo : IntPtr
) : int

Parameters

  • cTargets
    Type: UInt32

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

  • rgDebugTargetInfo
    Type: IntPtr

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

Return Value

Type: 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.

.NET Framework Security

See Also

Reference

IVsDebugger Interface

Microsoft.VisualStudio.Shell.Interop Namespace