Process3.Attach2 Method (Object)

Article
02/21/2011

Similar to Attach, causes the debugger to attach this process, except that it allows you to specify an engine or set of engines.

Namespace: EnvDTE90
Assembly: EnvDTE90 (in EnvDTE90.dll)

Syntax

'Declaration
Sub Attach2 ( _
    Engines As Object _
)

void Attach2(
    Object Engines
)

void Attach2(
    [InAttribute] Object^ Engines
)

abstract Attach2 : 
        Engines:Object -> unit

function Attach2(
    Engines : Object
)

Parameters

Engines
Type: System.Object
A Engines collection.

Implements

Process2.Attach2(Object)

Remarks

Attach2 allows you to attach to a process using a specific debugging engine or set of engines. The Engines parameter can be a single BSTR, a collection of BSTRs, a single Engine object or a collection of Engine objects. If you specify it as a BSTR, the first few characters of the engine name or its ID (GUID) can be supplied. The list of engines is specific to a given Transport.

Examples

' Macro code.
' The examples below illustrate how to attach to default, local, and 
' remote processes.
Imports EnvDTE
Imports EnvDTE80
Imports EnvDTE90
Imports System.Diagnostics
Imports Microsoft.VisualBasic.ControlChars

Public Module Module1

    Sub NativeAttachToLocalCalc()
        Dim dbg2 As EnvDTE90.Debugger3
        dbg2 = DTE.Debugger

        Dim attached As Boolean = False
        Dim proc As EnvDTE90.Process3
        For Each proc In DTE.Debugger.LocalProcesses
            If (Right(proc.Name, 8) = "calc.exe") Then
                proc.Attach2("native")
                attached = True
                Exit For
            End If
        Next

        If attached = False Then
            If attached = False Then
                MsgBox("calc.exe isn't running")
            End If
        End If
    End Sub

    Sub DefaultAttachToLocalCalc()
        Dim dbg2 As EnvDTE90.Debugger3
        dbg2 = DTE.Debugger

        Dim attached As Boolean = False
        Dim proc As EnvDTE90.Process3
        For Each proc In DTE.Debugger.LocalProcesses
            If (Right(proc.Name, 8) = "calc.exe") Then
                proc.Attach2()
                attached = True
                Exit For
            End If
        Next

        If attached = False Then
            If attached = False Then
                MsgBox("calc.exe isn't running")
            End If
        End If
    End Sub
End Module

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