DkmProcessAttachRequest Class

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Start

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

DkmProcessAttachRequest is used to describe the process that debugger should attach to.

public ref class DkmProcessAttachRequest

[Windows::Foundation::Metadata::WebHostHidden]
public ref class DkmProcessAttachRequest

[Windows::Foundation::Metadata::WebHostHidden]
class DkmProcessAttachRequest

[System.Runtime.InteropServices.Guid("7c0ada54-d17e-0067-cb5e-5a8169507663")]
public class DkmProcessAttachRequest

[<System.Runtime.InteropServices.Guid("7c0ada54-d17e-0067-cb5e-5a8169507663")>]
type DkmProcessAttachRequest = class

Public Class DkmProcessAttachRequest

Inheritance

Object

DkmProcessAttachRequest

Attributes

GuidAttribute

Properties

Connection	This represents a connection between the monitor and the IDE. It can either be a local connection if the monitor is running in the same process as the IDE, or it can be a remote connection. In the monitor process, there is only one connection.
DebugLaunchSettings	Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).
EngineSettings	Contains the session-wide debug settings. There is one instance of this object per engine Guid (ex: one instance for COMPlusOnlyEng2, one instance for COMPlusNativeEng).
HostingProcessLanguage	[Optional] Unique id for a programming language. These values must also be registered under $(RegRoot)\AD7Metric\ExpressionEvaluator and returned from symbol providers (through GetCompilerId) and language services (through IVsLanguageDebugInfo.GetLanguageID).
Path	Full path to the starting executable of the process.
ProcessId	Id of the process which the debugger should attach to.
StartMethod	DkmStartMethod describes how the debug engine started debugging this process.
StartTime	64-bit date time value indicating when the process was started. The start time along with the id and the machine where the process was started can uniquely identify a process. This can be set to 0 if this is unknown/invalid (ex: minidumps). This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).
UniqueProcessId	Value to assign to the 'DkmProcess.UniqueId' field. This Guid is generated by the port, and is used to uniquely identifies the process object.

Methods

AttachToProcess()	Causes the debug monitor to attach to the process. Before this method returns, the debug monitor must start an event thread (or reuse an existing event thread) and create the DkmProcess object on the event thread. Creating the DkmProcess object will send a process create event. Note that this method may only be called in response to the Visual Studio debugger package requesting an attach. Components that wish to attach to another process should send a custom event to a visual studio package. From a package, an attach can be requested through the IVsDebugger.LaunchDebugTargets API.
Create(DkmTransportConnection, String, Int32, Guid, DkmStartMethod, Guid, DkmEngineSettings, DkmDebugLaunchSettings)	Create a new DkmProcessAttachRequest object instance.
Create(DkmTransportConnection, String, Int32, Guid, DkmStartMethod, Guid, DkmEngineSettings, DkmDebugLaunchSettings, Int64)	Create a new DkmProcessAttachRequest object instance. This API was introduced in Visual Studio 14 RTM (DkmApiVersion.VS14RTM).