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