DkmProcessAttachRequest.Create Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Overloads
| 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). |
Create(DkmTransportConnection, String, Int32, Guid, DkmStartMethod, Guid, DkmEngineSettings, DkmDebugLaunchSettings)
Create a new DkmProcessAttachRequest object instance.
public:
static Microsoft::VisualStudio::Debugger::Start::DkmProcessAttachRequest ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, int ProcessId, Guid UniqueProcessId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Guid HostingProcessLanguage, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings);public static Microsoft.VisualStudio.Debugger.Start.DkmProcessAttachRequest Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, int ProcessId, Guid UniqueProcessId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Guid HostingProcessLanguage, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings);static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * int * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Guid * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings -> Microsoft.VisualStudio.Debugger.Start.DkmProcessAttachRequestPublic Shared Function Create (Connection As DkmTransportConnection, Path As String, ProcessId As Integer, UniqueProcessId As Guid, StartMethod As DkmStartMethod, HostingProcessLanguage As Guid, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings) As DkmProcessAttachRequestParameters
- Connection
- DkmTransportConnection
[In] 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.
- Path
- String
[In] Full path to the starting executable of the process.
- ProcessId
- Int32
[In] Id of the process which the debugger should attach to.
- UniqueProcessId
- Guid
[In] Value to assign to the 'DkmProcess.UniqueId' field. This Guid is generated by the port, and is used to uniquely identifies the process object.
- StartMethod
- DkmStartMethod
[In] DkmStartMethod describes how the debug engine started debugging this process.
- HostingProcessLanguage
- Guid
[In,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).
- EngineSettings
- DkmEngineSettings
[In] 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).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).
Returns
[Out] Result of this method call.
Applies to
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).
public:
static Microsoft::VisualStudio::Debugger::Start::DkmProcessAttachRequest ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, int ProcessId, Guid UniqueProcessId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Guid HostingProcessLanguage, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, long StartTime);public static Microsoft.VisualStudio.Debugger.Start.DkmProcessAttachRequest Create (Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, int ProcessId, Guid UniqueProcessId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Guid HostingProcessLanguage, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, long StartTime);static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * int * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Guid * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * int64 -> Microsoft.VisualStudio.Debugger.Start.DkmProcessAttachRequestPublic Shared Function Create (Connection As DkmTransportConnection, Path As String, ProcessId As Integer, UniqueProcessId As Guid, StartMethod As DkmStartMethod, HostingProcessLanguage As Guid, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, StartTime As Long) As DkmProcessAttachRequestParameters
- Connection
- DkmTransportConnection
[In] 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.
- Path
- String
[In] Full path to the starting executable of the process.
- ProcessId
- Int32
[In] Id of the process which the debugger should attach to.
- UniqueProcessId
- Guid
[In] Value to assign to the 'DkmProcess.UniqueId' field. This Guid is generated by the port, and is used to uniquely identifies the process object.
- StartMethod
- DkmStartMethod
[In] DkmStartMethod describes how the debug engine started debugging this process.
- HostingProcessLanguage
- Guid
[In,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).
- EngineSettings
- DkmEngineSettings
[In] 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).
- DebugLaunchSettings
- DkmDebugLaunchSettings
[In] Settings supplied during a start debugging operation from a project system or other caller of LaunchDebugTargets (or various other start debugging APIs).
- StartTime
- Int64
[In] 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).
Returns
[Out] Result of this method call.