Engine Interface

Definition

A debug engine that is used to map to code type.

public interface class Engine
public interface class Engine
__interface Engine
[System.Runtime.InteropServices.Guid("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")]
[System.Runtime.InteropServices.TypeLibType(4160)]
public interface Engine
[System.Runtime.InteropServices.Guid("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")]
public interface Engine
[<System.Runtime.InteropServices.Guid("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")>]
[<System.Runtime.InteropServices.TypeLibType(4160)>]
type Engine = interface
[<System.Runtime.InteropServices.Guid("8CEA6D39-EBEE-4DE9-B282-B5CECE9C9861")>]
type Engine = interface
Public Interface Engine
Attributes

Examples

Imports EnvDTE  
Imports EnvDTE80  
Imports System.Diagnostics  
Imports Microsoft.VisualBasic.ControlChars  

Public Module Module1  

    Sub ShowDefaultEngines()  
        Dim dbg As EnvDTE80.Debugger2  
        dbg = DTE.Debugger  

        dbg.HexDisplayMode = True  

        Dim transport As EnvDTE80.Transport  
        transport = dbg.Transports.Item("default")  

        Dim engine As EnvDTE80.Engine  
        Dim strEngineList As String  
        For Each engine In transport.Engines  
            strEngineList = strEngineList + engine.Name + ", " + _  
            engine.ID + ", " + engine.AttachResult.ToString + NewLine  
        Next  
        MsgBox(strEngineList)  
    End Sub  
End Module  

Remarks

Used to determine how the debugger will debug based on the code. This corresponds to the Attach to Process window.

An Engine object is used to specify what type of programs are intended to be debugged in a given process. For example, if you want to debug only managed code inside a process, attach to the process using the "Common Language Runtime" debugging engine. If you want to debug both managed and unmanaged parts of a process, attach with the "Interop COM+" engine.

Properties

AttachResult

Gets a result indicating whether an attached engine failed or not.

Collection

Gets the Engines collection.

DTE

Gets the top-level extensibility object.

ID

Gets the ID GUID of the debugging engine.

Name

Gets the name of the Engine object.

Parent

Gets the immediate parent object of a Engine object.

Applies to