IVsDebugger.LaunchDebugTargets Method

Article
2013-02-04

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

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

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via